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Task management 
has never been 
this easy. Let Things 
handle your to dos and 
start being more 
productive every day. 

















Record. Edit. P 


Using wlreTap Studio, you can record the discrete audio output of any 
application, as wetl as all system audio, or record audio input from any 
micro phone, Eine-in, or audio input hardware. 


If you can hear ft, WireTap Studio can record it* 



Download your free trial now: http://wvyw.AnibrosfaSW*corn/mad:€di 
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An underwater adventure awaits... 


Download your free trial now: http://www>ArnbnDslaSW*corn/mai;±ecH 



Balance bloodlust with strategy In this furiously-paced 


real time war game where you pit your armies of 
stick men against online opponents or single player 
to control the fractalized world of multiwinia. 
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Download your free trial now: http://www*AmbrosiaSWxom/mactech 
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Live sound effects on tap! 


Use Soundboard to enhance your podcasts or 
with sound clips, effects, or musical accompaniment. 


Download your free trial now: http://www.rtmDrosfa:^w.com/macuecn 


WireTap Studio* Aquaria. MulriwEnia. Soundboard* Ambrosia Software, Inti, and the Ambrosia Software logo are registered trademarks of Ambrosia Software, Inc. 
System nequirements for the above applications are prominent on their respective product pages. See above links. 

















































If a picture is worth a thousand words, 
imagine how priceless a movie would be... 


Snapz Pro X allows you to effortlessly record anything on your screen, saving it as a QuickTime® 
movie that can l>e emailed, put up on the web, or distributed however you want. 
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Why take a static screenshot when Snapz Pro X makes creating a movie just as easy? 

In addition to a video capture engine that is 20 times faster than anything else on the market 
Snapz Pro X has so many other new features, youll quickly wonder how you ever lived without it! 


Download your free trial now: 
hllp;//wwvv.AfnbrosjaSW.com/MacTech 
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Universal 


Snapz Pro X requires Mac OS X 10.3.9 or later. Snap? Pro X. Ambrosia Software, Inc., and the Ambrosia Software logo 
are regisloreri trademarks of Ambrosia Software, Inc. C^uickTime is a registered trademark of Afiple tiic. 
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1.5 timeis and Jithium-ion i$ good for 3"S years of recharges 

Retractable USB cable, 1l0'240y AC wall oharger, and duat'port USB car 
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From the Editor 


MM Me tiffinildy are living in interesting times- And difficult times. Thanks to gkrfral ecomimic nuctuatiems, 
businesses laige and small have been generally hurting. Consultants, which business can outs^>urce ti), 
W W tend to l^e doing well, and otliers are working for larger companies that are holding on. We encounter, 
and w'riic to, people in each of these categories. And MacTecli wants to help you excel no mattcT what you’re doing. 

Seems like pec^ple are IcUing us: year-tcxlatej Maclech is vip 12% compared to the same |>eriod last year (2008). 
Tliere are more articles, more ad pages and more readers. In Fata, the Lssue you're reading now is the largest issue 
of MacTetii since 2001, and it's larger tlian any other Mac-oriented Magazine in June. 

Wlien llie eoriipetilion Ls fierce, you ain't have enough infbmiLition, Many of you may l>e reading MacTech for 
the first time—or the first in a long time—tlianks lo W^TC. If yon Ye at WWDC, you’re doing so to l:)etter and advance 
yourself. Thai's what we look to do year round, Like WWDC, we cover m;my segmenis: IT/Consultanus, Developers 
for OS X and iPhone and those new hybrids— Sys Admins ihkii am develop. 

Speaking of WWDC, make sure yt>u get ilie most out of it. Of course, diat means sitting in on sessions :ind 
sparking with Apple Engineers. Also, lie sure to connect witli your fx.crs! T\m Ls possibly the most importimt pan of' 
the week. After ifie week is over, ifs unlikely that you'll stay in close coiitaa wiili any Apple employee that you meet. 
Nor am they give you personal support tlie remainder (>f the yor. Hopefiilly, thougli, you’ll continue to stay in toticli 
with the peers you meet at the conference - Ix" ii direugli public mailing lists, regional meetings (like Oxxjal leads, 
Apple Consuliants Network memlx*rs or otlier Macintosh User Git)ujHy|X‘ gadierings) (jt even direttiy. 

So, wliat Is on our a)lleaive mind tJit.s month? Well a little bit of everything. As ytxi can see l>y die cover, Public- 
Key Encryprk)n (PKl) Ls weighing on us. In die finil of a series, Michele (Mike) Hjnrleifsson gives ii.s a gentle 
intixxiudion lo PKl for all of those tlxit need to leani alxiut tliis uufKirUmi topic. 

New autlior Sengan Ikiring-Ciould shosvs lis a very inteioaing way to geneiate a backtrace t>f die -stack fur Obj-C, 
When your program dies a horrible death, and you need to figure oui Ikw you got to the point where it ailually 
crtLshes, this is a great resource, 

Michael Gbiel and Oliver lAispi.sil aintinue their “Inspiied by Life'" column on starting an indeix-rKlenl .sofiware 
company. Greal idc'ius tt) lx* found, so, follcra' along! 

'I'his month’s Mac in the Sliell continues iLs "learning Pyihon on the Mac" series and delves into l^OlifC, or, 
acct*ssing native Cocoa and Obj-C using just l^ion. Tills column looks at accessing grtaips vb die Adda-ss HcKik, 

William Smilh returns with another article desc-ribtng ways to integniie OS X into a MicrofRilt shofi, 'Hiis lime, 
he reaches all alxHJi the commonly found Sharc‘jx)int. 

Back with another article in his series on st>ttwaiie jxickaging Is Jose* Cruz. Tliis monili, he tackles a unique w^uy 
of aistomizing ihe insLiller via a plug-in. VoWow him througli aeaiing a jilug-in using Xaxle. 

Greg Neagle, once again brings one for the Sys Admin playlxKik: metliods and reastining Ixhind ainiiing scripts 
on end-user wcirksrarions. Ytiis is often an aa-a tliat many system administraiors struggle with. Never feif, (rreg lays 
it out clearly. 

In Ills Road to Code column, Dave Driliin covers saving user preferences using NSllserl^faulls. Who doesn’t 
like an appllcarion that renieml'>eis wliur diey like? 

'rhere's more, but 111 wriip up by pointing our this montlVs MacTcxh Spotlight: Philip Gowaid and Git’g Scown 
from SmiltOnMyMac. SinileOriMyMac has Ixen pnKiuGng great utility software for C)S X fur a lung time ami lias 
Ixen thixaigh some ups and downs in tlie Mac market. We're ha|ipy to fcjture the nvtbunders of this company this 
month. 

Enjtiy ihe show; .strak in the ntfw knowledge. See you next month, 

Edward Marezak, 

Hxeaitive Editor 
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Mac in the Shell 


by Edward Marczak 


Python on the 
Mac: PyObjC 

Writing native Cocoa apps 
using Python 



Introduction 

Over the last iew months, we've been covering the basics of 
Pytlion. Aside from a few OS X-specifk issues raised m the fiist 
article (how to get die built-in dcx.',s working, cicj, you t‘oijld regally 
take the lessons le^irned an^'where - Linux, Windows, or any 
plaitbnn where you find a Python mntinie. We needed tliose 
teics - and we liavc rnoR: to cover, tenainly. However, iliis is 
MacTeeb. 'Hiere’s plenty that i>iie can do witfi sojiie very irasie 
I^hon and Python/Ohjettive-C bridge, letting you tap into CtKoa. 
0:xx>a? Isn't dial ne,sc‘rved for 01>j-C dcwelopers? Nopt‘. While 
Mac'lech has covered tliis concejM Ix^fore (Scott Corc^ly, '’I^ltion 
Cocxia: Delicious/ February^ 2009), I'd like to put [c:}geiher the 
lessons learned in diis column altmg with a moa^ utilitarian 
approach. 

Read The Fine Manual 

Anytime we'ie working with Ccxxia and the teclmokrgies in 
OS X, well probably he pouring through the develofx^r references 
at htfp://developerapplexom. You^ll need an ADC aciount to cio 
so. Even die fk^c variety w ill do, -so, go sign uf) now if you haverVt 
alretidy! 

Once you're logged inkJ the Developer ConnecTion, head to 
the developer dcKs at http://deyeloper.apple.com/ 
documentation/. More often than not, you'd search on die topic 
youk* after. Sometimes, you find gcxxi docximentation spread out 
over several categories. Today, we'd \x: kxiking ai getting 
intbnmation out of Address Book. Taie to fonii, die dtxs are 
somewhat spread out. Til make reference to e^ich as I use it. In 
shoit, for now, fii^t search on "address Ixxik”. 


Translating Obj-C 

First, wily would we want to do this? Tliere arc certainly aises 
wiien developing for OS X where straight Obj-C is die right choice. 
However, Fm taking this from a System Administrator's ix>int of 
view'. Often, a System Atlminisirator is already writing fiasic sc'ripts 
in bash. I love kish, liut tiieie's only so far diat it'll get you widitjui 
l:>ecoming painful. If you're waiting a saipt in Ixish and it passes 
tile 4 flincLions milestone, it may be time to txmsider a language 
more suited to your task. For example, bash isn't really great with 
daialxises. 

Sure, you an use the mysql binary, pipe the output to awk, 
and manipulaLe results from there. Rut is that the best use of your 
time and talend' Ever deal with arrays in iiash? Pain, Wliile I may 
recommend Itython or Ruby as a step up in general, these 
languages are made even more special under OS X thanks to 
Afiple's inclasion of an 0\i\-C bridge. BridgeSupfX>ri opens up OS 
X's native APIs to Itython, Ruby and JavaScTipt. 'lliis is available 
and .standird on every Mac aitming 10.5 or higher. (10.4 suppon 
is available, l)ul you'll ntx-d to install it yoiirsc'lf, which is oiiLside 
the scojie of diis article). BridgeSupfXin deals widi :^dl of die 
beliind-tlie-scenes work of averting lietween Itython and the 
native frameworks. Tfie first challenge to this techniciue is 
inteqxeting the dcKiirncntatitin. We're going to code all of this in 
Python, and die dcxrs are directed at fieople writing in C and 
Objeclive-C, Anyc.me rememlier having to translate Mac 'Icxillxix 
Al’I eaJLs from Pasek to C? I digress... 

Now' tliat w^eVe covered Pytlion dassc*s, you know alxiut 
sending a message to an oliject using dot notation. In last mondVs 
t:olumn, die BankClass example ckiss contained deposit and 
withdraw medKxIs. A new class could Ix: cjeated and a metfKxl 
ailed in the following manner: 

acet = Account('Joan'♦ ’Smith') # Create new account 

acctl-Deposit(50) # Note use of class method here 

However, T we got dii.s infonnation from Apple's deveiofXLT 
documentation, you'd .see Mimediing like this: 

tacctl Deposit:5Ql 

lliis was covered in depth m die "Python Oocoim Delicious" article 
referenced eitrlier, bui I'll cover die l>ask: rules 

As you c'an see, Obj-C uses squam bmckeis \o send message's 
to objects. 4he easiest call to translate is a simple message with no 
parameters. Tfiis: 

[objecL message]: 

in Pydion liecximes: 

object.me3Gage() 
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Navigating the mobile world 

just got easier with iCooper. 


The demands to capture, organize, and retrieve dynamic data in a mobile 
environment are rapidly increasing. One company, iCooper, gets it. 

As the industry leader in dynamic data mobility, we develop and publish 
software that leverages the growing power of the iPhone, enabling 
enterprises and individuals to optimize their activities, workflow and 
productivity. Applying critical thinking and new ideas to the way users 
relate to data, tCooper creates simple, inteliigent, mobile solutions to 
improve the lives of our customers. 

ERP on a mobile platform? We can do that. 

Mobile design and manufacturing integration? We can do that. 

If data needs to move with you, move to iCooper. 



Visit icoopeccom tor our story or call 
us at 360,844.5807 and tell us yours. 


iCooper 
















You make your living from your brain. 

This ability to create is tied directly to your 
ability to focus and concentrate. 

Brain Toniq is no marketing gimmick. It 
works by providing simple access to the 
world's most powerful brain-enhancing 
botanicals. Its focus effect comes from 
l,800mgof natural nootropic compounds, 
not caffeine. 

Zero caffeine, zero processed sugar, organic 
agave nectar. Kosher. Highly effective. 


Brain Toniq. You need this. 



tonlQ 

^ clean and 
think drink. 



BfainTonkj.coni 
8-4 fi. 02. f250mL) 



Zero Caffeine [ Organic Agave Nectar } Highly Effective 


When a metiiod tikes ptirjimetcfrs, Olij-C placa» iheni in-line: 
iobject message:40 key:SO]: 


Python keeps its usual formiiL here, .separating the metlicxi 
Oil rue and parameters. Each measage and frarameter gains a 
trailing undenscore characien 

ob j[ ec t . mes an ge_key_ {4 0 , ^0) 

Essentially, each colon is rc-placed by an underscore - ev'en if 
there's only one parameter For exanii)lc: 

object, inesaage_(40) 


To iasiantiate an objective-c dass in the first place us faidy 
straightfo^v^^. 

object ^ HSObject-allocf).Init£) 

Let’s see aU of liiis in aaion, 

Reading the Address Book 

'Ihe l^^iuty of using a language like Python is thiit you can 
autlior in :Miy editor you like, save and run. This skips the 
compiie/link phase so famtiiar to Ol^j-C dwio|>ers. So, pull up 
your favorite editor—rememlx.*r fotu tluic most editors will l>e able 
to recognize Python code and syntax color, indent properly and so 
on, lor you—and let's go. 

Contained in /System/Llbrary/LTameworks/Pytlionirarne- 
wofk/ are the modules lliat Pyilion uses for BridgeSupport. Tliese 
can simply be imported into Pytlton First thing us first, our magic 
shebang line: 

python 

(Rememlx.T, if you have nuiltiple versions of pytlioo on your 
system for some reason, under ID.S, the built-in BridgeSupport only 
w'orks with l^ion 2.3. If you need you nml to explicitly call that 
vcfsion, then do so). From here, well ini[xjrt llie AddressBcK.>k 
framework: 


from AddressBook iMport * 

It's rare tliiit 1 like or use die 'fn jui f>lah import *' style, but there are 
limes when it makes petfea sense. lliLs, I feel, is one of them. We 
talked exteasiwly about imprarts and namespaces in previous 
articles. 

Ijefs create a new^ itistunce of an address Ixjok oliject: 

fiBotik = AMddressBook.sharedAddressBookt) 

Painless, riglit? Tliis returus Uie address [xx>k for the bgged-in 
user Keeping this simple, let's grab the 'me' card for liic logged in 
user and prim it oui; 

IByRecord = aBook.mcO 
print ayRecord 
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'Phat's it! In 3 lines of code, we get a good amount of infomialion. 
HereVs tlie output: 

ABPerson (0xlab0a40) ( 

ABFersonFlaga : 0 

: I 

* child Edward R Marczah 

I 

Address : I 

* w<jrk [ 

City * Aivytown; 

Country ^ USA: 

CountryCode " us: 

State “ AA: 

Street = ^555 Any Street"; 

ZIP ^ Lllll: 


) 

AIHTnstani ; f 
* home layaia 

1 


I 


Creation : 2005*10*28 0^:45:40 0400 
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Each of tlic pTt>ix.^rtieji in tlic rca)rd can i)e ^iccessed and 
iterated over individually. Each pmi^erty^ lias a unique name used 
for thLs purpose. An iUiiminating method of dLscofvering this, 
(lesides the Apple dtxairncnUition is to um? the dir() funaion that 
weVe seen previously, tiave your work and open a new document 
that aintains this simple code: 

#1/uar/bin/env python 

import AddressBook 

X - dir(AddressBook) 
for 1 in z: 
print i 


When you run it, you'll gel an af^stiluie im of output, pipe 
it through less or use a GLil editor that can run tlie ctxle in its 
own window. It'll kxik like this: 

ABACE 

ABAa 

AiBAc c es sibllityMockU lEl eweti t 

ABAddPropertiesAndTypea 

ABAddRecord 

ABAddToGr oupConmiand 

ABAdd res sAttributedString 

ABAddressBook 

kABATMEomeLabel 
kABAlMI nstantProperty 
kAHATMWorkLabel 
kABAddressCityKey 
kABAddrcsuCount ryCodeKey 
kABAdd ressCoun t ryKey 
kABAdd resai lome Labe1 
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kAB Add r es E P ro p erty 
kABAddressStateKey 


kCFXHLTr eeJSi: i o rLoc a t i on 

kfTFXMl.T r eeK r r Q r S ta t n sCod e 

kEventABPeoplekickerBiapIayedPropertyChbanged 

kEvEnLAfiPi?opli5PickcrGroiipDoybleClickGd 

kEv e nt AB Pe op 1 eP i c ke t:Gr oupSe 1 ect ionCha n ged 

kKv on t ABPe np 1 cP I c k c; rNa mcDoub 1 eC 1 i c kod 

kEve ntABPeopJePi tke r Hme S o 1 ec tl onChanged 

kEven t ABi'eoplePi ckerValueStilet’ 1 loriChanged 

kEventClassABPfioplePicker 

kE VG n l P a ra itA B P ic kG t Re f 

objc 

protocols 

super 


Tills lists every liinction and constant deflnirion in the 
rniiiiework. In this case, we^re interested in tlie blcx^k where each 
constant lias the ’kAB' pieiix. Each of’ tliese properties represents 
a potential field in the address lxx)k im>rd - not all jnnst Ix" 
jircscni. So, how am wc Leil which fields are [>re,sent in a given 
record? We can ask. Back to our original ccxle! 

Here’s a complete l^hon solution ro clumping the c'unent 
user's Address Bcx)k, I'll explain tlie parts not yet covered after tiiis 
ccxie listing. 

Listing 1: dumpAB.py 

Ifi/usr/bin/env python 

froiD AddressBook iotport * 

aRook = ABAddressBook.sharedAddresirBookO 
for person in aBook.peopleO : 

properties " peraon.allProperties() 
for prop in properties: 

if prop = "com.appie.ABPernonHnProperty": 
continue 

el if prop ” "^coin-apple-AiliTmageData^’: 
continue 

print prop* * person* ve 31 ueForProper!y„(prop) 

print ' '*6C 
print 

Tlie people () method retums an amiy (an NSAnay, 
specifioilly—the Obj-C Bridge deals with converting between the 
0[y]-C types and Python lyfx*s). We've previously covered Python 
for kx)ps, and this one is no different. Hiis loop ita-ates over each 
entry reairned by the people)) method, assigning it to person 
in eac;fi iteration. 

With each person, we use tiie allFroperties () method to 
determine the properties contained in that record. Then, w^e use 
anoilier for Icxip to print only thase propertie^s. Ncxe the if 
statement in this block: iliere are two properties present in each 
record that w^e're really nor going to do anytiiing witli. Dsing a 
continue statement lets us restart the kx>p a! the top. 

Now, tills Isn't going to win any ctxling congxititions, but kx>k 
at bow simple it is. No compiler or sjiecial IDE was needed to 
generate or nin any of this. 
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NEVER RUN WINDOWS AGAIN. 
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WINDOWS SOFTWARE DEVELOPER? 
LET US HELP YOU PORT YOUR 
APPLICATION TO THE MAC! 


GET20% OFF INSTANTLY 


Wanna help me prove to my coworkers this darn ad was worth it? Next time you 
order from codeweavers.com, include the dealcode MacTechWWDC, and we'li 
take 20% off the price of your Crossover purchase. Tell ‘eei ion sent you!" 


;CQp^ljj^t,2O0$GadeWBavRraJiiC; r8served..CrossOverMatfSa 
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Micmsott-CofpOTfttJort tn the States and plJifirccuFttF^.. All .0fcnfirtrH^emaTh5.;and i?si?sU^ Ifatlemarkij' 
are owned fay ttieir respeclfve companies 


What Happened? (Maybe) 

Some of you may have seen an ermr pop up while running 
tills piogranL Sometliing alxjul u "UnioKJeDecodeEnior", Wliat 
happened? Tliis, pLirtiaDy, ts tlie oid-scliool Unix ASCIl-ness 
ailliding with mcxlem sensibilities. Yoti'll only see this error if one 
tjf your address Ixjok cntriL-s lias Unicode ciuiniaers in ii fateeni 
marks, Asian/I lel^iew/Rassian character sets and so on). Well, OS 
X is built to deal with this. Now, this tlepends on tlie environment 
in which you nin this* Terminal.app shtHild actually have no 
[iiolilein as its Uniccxlc compliant, Sutprisingly, some GLU text 
editors .still don't handle Uniaxle properly, or, just need a little help. 
One thing you can do is give liie inierpRiter a little hint: 
immediately following the magic shelxmg line (#1 /usr/bin/env 
python), include the following; 

t encoding: utf-S 

'lliLS explicitly sets tlie encoding of the document. Additionally 
Fython itself has built-in support for Uniaxle .strings. When 
printing a siring, prefix it with \i' to .sptx'ify 1 Inktxie oiitpiih like 
tills: 

print u'This is a Unicode string* 

If you're printing a variable, it's .similariy easy: 

print % (variable) 

Tills Is just one of Lh(xse things lhai 0,S X ust‘rs exptx:!, ami .sciipi 
authors need to Ix'ar in mind, Kiml of like spata^ in filenames,.. 

Conclusion 

Ihere are actually a few more things we can cover alxiut the 
Obj-C Bridge and its use in l^hon, I kiwever, we accomplished 
our goiil for this imntii. and 1 Ix^pt' you cm see how easy some 
of tliese Ixisic tasks aie. Yuu1l find tlial tliere aie often scwral ways 
of approacliing die axle when using BridgeSupport, The methtxLs 
used in diis article are the mosi appropriate for the task at hand. 
5cv die Rdeiences section Ix'low for the sfxtific Addiessfkxik 
documentation that I used tti deteniiine the Ixilk of this. 

If we weic^ more lanbitious hem, we (^)iild certainly do more 
widi the data returned. IJke write it out ;i,s a CSV lile. AddiessB(x>k 
alsti sufiixirts gmup infonmtiiin, whieli I aeatally use faiiy often, 
hut that’s a topic tor next month. 

Media of die month: I know, I usually .suggest a gtxxi lxx>k, 
movie or music CD fiere, but this month Is a liale different. This 
month's suggestion Ls the outdtxjrs - dt>n'i forget alxiut id 
.Seriously Tm not re:illy a 'sun pt^rson,^ l>ui it is nice lo take a walk 
witli no laptop/phone/eltxtninic device. *Dike a bike ride. I hive a 
picnic. Take a (real) hike, Hxpenemx* it. Just don't forget that 
there's a world outside of the U)D that we often sit a ftxH or two 
away fttim. 

Hopefully you're teading diis at Apfile’s {st>ld out, again!) 
WWTX. Most of us from M;ic'lech aie here tcxi (and you may liave 
received diis i.ssue while on line for die Keynote - welcome!). Ping 
us, slop us in die halls - jir.st ,s;iy liello! See you next month. 
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invente 


All we know about starting dn Apple business, 
from the Idea, to product launch and beyond 


Inside Inspired By Life 

In 2fXl6, I sLarted ic> Lum my idcra inin a sol I ware protoiype. 
The feedback I got (or tlie i)rotc>tyi:>e mast ixxjpie was: 
'Interesting idea, is it based on academic research? Because the 
GLIi sure looks like it?’ 

It lxx:time clear tliai a GUI exfx^n is needed lo turn the 
piototype into something people love to use. While searching on 
the Internet for a person like that, Michaers welnsite popped up, 
and after testing one of his :i[)pliLaiions, I allied him right away. 

After tile I list aill, Michael w^ls not convinced iJiat niy idea was 
worth investing any time in, especially when 1 told him tliat my 
hnancial resources am very limitaL However, he at leisi tcx)k rlu^ 
lime to clieck my pnitotype out as well as a lliree-fiage dc.scripLion. 

After one week, he changed his mind. His cutitisity was stined 
snfticiently and we schetiuled a meeting. After shaking hands, we 
immediately started to talk about the idea in general and what it 
could look like in sSoftware, As soon as Michael l>egan to pin|x>ini 
all of the weaknes,ses in my concept, I was tliomughly convinced 
that he’s the riglit person for the job, Michael rlidn't care whether I 
liked what he liLid to say or if it damaged my egt). He was sold on 
tlie ideti - no time to waste on a potentially damaged ego! We were 
kxiking for the right metaphor to turn the ideti into software, 

Midiael: "Okay, Oliver lieie's a stack of index cards. Descnl>e 
the concept liehind your idea.'’ 

We toyed around with the index Girds for more tlian three 
hours. 

Oliver: "Why don’t we use the index card as tlie metaphor?" 

Michael: "It seems proniising, but we shouldn’t stop here. Let’s 
chec k some more options out on how we c:an do ii." 

Two days later Michael called me to tell me tliat the index card 
fits the lx?st as a metaphor. It was just like aniving in tlie town 
called Fiireka! 

Introduction 

Charles H. l>uell, conunissioner of Uie United Stales f’aLentand 
'trademark Office in 1899^ is allegedly the one who stated: 


“Eveiytliing po.'isihle that can Ix^ invented Ixis lx*en invented." 110 
years later, you now have another chanc'e to prove ihar the 
opposite holds tnie. To Mi-. Uueirs credit, rumor Iuls it tliat lie was 
n(X [lie one who made tliis statement after all. It .seems to be a 
jxatentiy false, modem myth, However, your chance i.s not just a 
mytii! 

If the rea,son why you pnigram Mac or iPlionc applications is 
just for fun, it should not matter what otlier [leople think about 
your idea or ho%v many download or buy it. Just go ahead and do 
it! 

However, die situation changes when you want to make a 
living out of it, l:)esides just having ftin. What you nec^l now is an 
application that people are willing to pay for - and not just ont:c 
hill also on a legular Ixisis. First and forermjst, you must liave a 
[errihe idGi that you can turn into a lieautiftilly crafted program. 

In ihi.s article^ we wall tell you everything we know alxiut hew 
to stimulate curiosity^ how to test lui idea to find out whctlier or not 
it tmly is a lerriOc one, why you shcxild l:>uild up a goex) reputation 
at an early stage and what aiasequences you will lx: up against 
once you have decided to furn your terrific idea into a Ixautifully 
cralted Mac a]>tilicaiion. 

How to come up with an idea 

After ix'ople come up with an idea and you a.sk thein where 
they got it, tliey either say, "1 don’t know" or they try to rationally 
explain how^ straighi [heir line of tliought was. Perst>nally, I don’t 
really lx:lieve in all rational, straightforward explanations, iastead, 1 
go with the first one - "1 don’t Icnow.” lb us, an idea is a destination 
lowands which you travel. 

From curiosity to Eureka and back! 

All you ncxxl to do is to sum the journey in,side of you. Tlie 
very first stimulus for your mind Ls curiosity; tlie destination is 
Eureka (Greek; "I liave found it") = your idea. 


18 JUNE * 2009 


WWW, MACTtCH.COM 






version 3.1 


Snow Leopard Ready 



f 



New With Version 3.1 



V........ 

u* 

, ! '5 . ,=1 

_ ) 


eazydraw 

have fun drawing on OS X 

Illustrations 


Web Graphics 


"lilJ 




Technical Drawings 
Charts & Diagrams 
Text Layout 


EazvI^Draw 






















Getting to Eurekii is not a one-way fKitJi, biif radier, multiple 
pathN, Y(xi do noc ev^en hiive to choose lx?tween them. Since it 
mainly lakes sliapc iaside of your mind, let it decide on the best 
path itself. 

Here is our way to get from curitxsity to Eureka: 

T read a lot of lxK>ks: How to start a start-up li|>. How to create 
mind maps. City guide of London, Ink heart, |ust to name a few, 
Wlienever I a>riie across sometliing tliat I don‘t fully understand 
and I cannot find a satisfying answer quickly on tlte web, 1 go lo 
Anmon and seandi for a bcxjk. When tesiding tlte book, 1 ask 
m>^lf “What would this look like in softwaro?’’ Thai’s curiosity to 
me. 

Michael Uikcs a slightly different approach. He focuses on die 
reality of daily life and listens lo his oistomeis orefLilly. He asks 
himself how software can make life better or at least make it more 
fun. He’s a technophile. just like you. Here's a gcxxl example: While 
we were walking around Ijondon he said^ "WcHildn't it be gre^it to 
bring a digital city' guide for Ijondon along widi me? Wliai amid a 
digital version do for me tliat a printed ven^itrn cant^ In 
combination with a 3G iPlione and Google Mttps it could show me 
the shortest way to the Apple Store on Regent Street*" - airiosity 
and Eureka! (t Jnfortuniitely, Michael and I dklii'l luive a guide like 
diat so we took die mtxsi jxipular route* the result of w^hich was 
aching, blistered feet). Tlie guys from Pressclile demonstrated the 
.same ojriasiry and Eureka! 

Quite often, we ask ourselves “What wmild it look like in 
software?", liefore we gen to a town like Euix^ka - an idea into wliich 


time and money are well worth dedicating. Any other questions 
like: “Wlxj will buy it and at wliai prkxf ” or “How much mont 7 will 
1 make?" are simply secondary. 

You ,still tliink you do not have this type of airiosity? Well, yes 
you do, because you opted lo u,'5e OS X, 

The bottom line 

Until your softwaie ufiplic'ation actually goes lo market, you 
will spend many days filled with curiosity and Eureka. TIk" one 
ddng dial Is al^ikilely esstmtial Ls airiosity - the first stimulus for 
your mind. Once you liave ii, Ici your mind go wild in get to Eureka 
- your ideti. 

Now let's see if your idea passes the terrific-idea-test, 

Terrilic-Idea-Test 

If all you rouUy care alxHJl ls making money, program a game, 
for example, an ego sltooter and call it a *stniiegy game. If whar ycHi 
want to do Ls to make this world a Ixftter plac'e or to help otiiers to 
do so, just lest your idea. 

Test 1: Does your idea stick? 

Yt>y liave a loi of ideas night and day, ck>n*t you? Some of them 
come Ixick the next ckiy and agtan and again. Tliese ideas are 
sticky, Tliese are the ideas tliat arc wortli delving mto and dial are 
worth sjxmding the time on to trxplore them. 
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Tcxby, we realize that Uie stickine^JsS of our idea lias Ix^en 
growing over time. It was not that strong from tlie srarl. So, don't 
worry if the stickiness feels like a Past-lr and nor like Paitex. Your 
idea sticks, and that’s what counts. 

A sticky idea is also the source of eneigy ilmt you need to 
sustain up to the wry moment when you ask yourself''Does it all 
make .sense and will it jray off?” 

Test 2: Does your idea solve a pain fai the neck? 

Wlu) will no longer have a pain in the neck once they srart 
using your .software? 1 low would il make die world a belter place? 
Go out and find at least one pei^on who enjoy using your 
software' and preferably whe^ is willing to pay for it, too. 

Test 3: Does your better half tell you: 

“Please stop talking about it!” 

Others are often lietter in seeing what we really do with our 
tirnt!. You mi 100% certain that youVe found something diat is 
wortl^ investing more time in when yonr better half begs you to 
stop talking about it - at letist for om night! 

Wlien that happeas, ju.si give her or him a big smile, enjoy tlie 
evening togetJier and the next day, get back to your idea as soon 
as pQ,s.$ible. 

Test 4: Do others, not only friends, line up? 

The first people you talk to with alxiui ycjur idra are most likely 
your better l-uilf, clasest friends and family. Resist die tendency to 


trust their feedhick—l:)e it positive or negative, Ihey really, tally caie 
about you and that's the problem: Tliey care so much rliac they want 
to do all tliey can to make suic‘ tlial your endeavors do ri<H lail. 

So, just go out and ask i:>eople you have not met yet at parties, 
on the street, in pulxs, restaurants - In fact - jaracticaliy anywhere. 

One inifxjrtanl rule: Tell tXhers what you want to do- don’i tell 
them how^ yoifre doing it - thit is your own magic and secret 
ingredient. 

Test 5: Do experts' eyes light up? 

Maylx* you came up with an idea after reading a lxx>k, Ask 
die audior wliat he or she thinks alxnii your idea. Ask Uiem if they 
could recommend someone else to talk to. Search on tiie liiteniet 
for other experts and give diem a call. 

One iinfX)rtani side eftect; You're building up a rt:puraiion. 

Test 6: Do others design solutions for the 
same problem but not in the same way? 

1 assume dial your idea is at least in one way aimirarable with 
ours: It is not lotally new (new like (he very first Internet search 
engine). Tlieiefore, odicrx offer a solution for tlic .siime prolilem like 
you. And you want to provide a different solution. Tliat's great: Do 
they eiirn money with it? If they are earning money, there is a 
market, and a market is what you need. 
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Synchronize all your ITunes libraries into perfect 
harmony across multiple computers - everywhere 
you are! Easily access and merge your music and 
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• Copy tracks from one library to the other 
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• Find and avoid track duplicates 


Access your library from anywhere on the net 
Integrated music player & Tivo server 
NEW! Stream your music from any browser 
Detect and update modified IVIP3 tags 
Cross-platform Mac/Windows compatibility 
Free upgrades for life! * 





More information, including a free demo, is available online at ' ■■“.nv.supersync.com 





















r '' 

Protect your business with MozyPro online backup 

MozyPro is the simple and safe way to protect all the important files on your business computers. 

A copy of all your files is stored offsite in secure data centers, so you are always covered in the 
event of file corruption, accidental deletion, hardware failure or even natural disaster. 

Why take the chance? Get started today and save! Visit us online at www.mozy.com/mactech or 
call your industry representative at 877.669.9776 and receive 10% off your initial purchase when 
you use the promo code MACTECH10. 

Simple. Secure. Affordable. 

- Mac and Windows support 

- Online account management 

- Multiple restore options 

- The highest levels of security 

- Backup solutions starting at less than $5 
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© 2008 Decho Corporation. All rights reserved. 2162 Grove Parkway, Suite 200. Pleasant Grove. UT 84062. www.mozy.com. 


"MozyPro is the first online backup service I'm 
willing to offer my clients. No other company can 
offer as great of a service at such a great price.” 

• David O’Connell 
OConneli I.T. 







Test 7 (optional): Will someone steal 
your idea? 

tesides getting the core feedback, when we talk to other 
f)e<)ple alx)ui our idea we are often tusked whetlier we worry ahnii 
someone stealing our idea. 

Oiir answ^er is: “Yes, tills is a risk. But it is a risk w'e are liappy 
to take, fx^catise otherwise vve would ntwt:r get valuable feedback 
at an early stage. If someone steals our idea, of course we will lx: 
very upset, how'et^er, we still know tliat we am rely on our own 
idea. We very miKii doulit that aimeone will steal your idea after 
a five-ininute discussion. They do not know tlic whole story and 
they don't live and breatlie your idea ” 

Q)nceming probability: Idea thieves will most likely wait until 
yt)ur idc-a Is a successful producl before they come up with their 
own, copycat .solution. 

The bottom line 

How many times did you answer with a “Yes'? - The more' the 
lietter! 

Fie aware tliat a terrific idea does not necessarily translate into 
a mega success in temis o\ j>rc/it. However, il ckxs mean ihal 
you’re investing time and money in an Ltrea that promises ixsentiiil 
success, 'lliis Ls tlie liest thing you can hojie for at tliLs stage of your 
endeavors. You have finally made it to Eureka 

Reputation, an invaluable feature 

Just imagine thal ytRir gcxii is not to develop a softw^are 
application. Instead, you want to craate a new' hanirner. And now, 


youVe finally convinced the maaager of the do-it-yoursc# shop in 
your neighix)riiood lo display your new hammer tm ihe shelves. 
Youwe designed an advertising poster witli die slogan “New and 
revolutionary himimer!" How many orpenters do you tlmk will 
buy it? If you get lucky, maylie a few. Like everyone else, carpenters 
are loyal, tfiey stick lo die diings dial tiiey’re used lo and continue 
to buy the same hammer tliey always buy. 

So how can we convince carpenters to buy the new (itKaily 
unknown) hammer? Eidier we need is a high-price “Think 
Difterenr advertising camixiign or just one expert. Bring an exjieit 
on board who know.s how to use your hammer, who likes ir and 
wht> can hammer better resnlLs. Ncm^ imagine that the expert 
recommends your hummer to die editor of the carjienlLT tcxib 
magazine, they review your hammer and give it five nails. Ihe next 
rime you hear ftiom the do-it-yourself .shop manager, he w^ill most 
likely tell you to deliver more liammcrs as stxm xs (xxssiblc. 

A good reputation is a faitiire that you cannot buy - some by 
to fake it, but it doesn t pay off in the long am. No genuine expert 
will accept and buy into a fake reputation (expc'rts do know each 
tXlier). 

A good reputadon opens up doors to die people who are of 
umiosl value for tlie success of your idea. Talk u> experts and ask 
Ibr dick advice and help. You’d lx.- amaxed at how many peofile 
i\xe willing and eager to supptiri a young stan^up. Don't lx* 
.siirpris(.xl if the expert calls you and starts witli “1 tliought about 
yt>ur idea, ifs promising. I have an idea.. 

One coasequence of having u gtxxl re[iiitation alwiiys holds 
true: ‘Ihe better you get, the better you Ix'tter get. 
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Personal consequences 

My Ijcticr lialf liiis lieen supporting me since 2006, Right fttHit 
tlxr very start, I have always \)cen telling her; ‘'Just hang in iltere kyr 
three more months, darling.'' Bui three years Uier, she is now 
skef)iie:il yet still broking me liII the way. Why? The aaswer is actually 
ectsy - she coiiunitled heraclf to support my (jriginal idea ;ind she 
ck)es see progress. 1 talked to her alxnil iny Idea and she a^^t.‘d tbit 
it's definitely wortli a try. Her precondition: ''Keep on working w'itli 
your full-iiiiie ciiiployer until your start-up business pays off and, m 
return, yrui support my endeavors.'' I agreed, happily. 

Personally, I wt)ukl never have believed that it takes up so 
much time and gobbles up practically all of my financial 
resources in order to turn my idea into a real product. Rut it 
wcjrks out! You have to work tefore and after your full-lime jo!>, 
you dedicate your weekends, a lor of leisure time and even 
vacations to your terrific idea. 

How do you think the ones we tally cuie alx>ut feel when tliey 
just see us sitting in front of the computer for endless hours, days 
and nights, and all cJ lliat just in the hope ihal one dtiy in the ftimre 
(that could Iv in a few years or in the worst case scenario even 
ncvcT) tliat you bring the same money home that you do today with 
your nine-tt>five jolt? Tliafs wliy you must reserve c|ynlity time for 
the people you truly care iibmL You have to find iJic right balance 
lx.lwcx'n pt^rs«)nal life and work! Rememlx^r, you need time to relax, 
too. Your endeavor is a maraihon, and nor a sprint. 

The bottom line 

If you don't w'ani to destroy your love life or the staidfksi, 
reliable telationsla[:)S wiili your closest friends and family then just 
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get them onto the l^andwagon! Just talk to dim alxjut your dreams 
and what tliey will get out of them. Get tlicrir commitment - and 
in my opinion, getting it from your better lialf is by far the most 
important one! Show' tlieni liow you are making pn>gress. 

One pasitive side effect: They always knew where ye>u are - 
right in fn>nt of your computer. 

What’s next? 

It's easy to lx: curious all day long. Sewne day your airiosil)'* 
will lead to Eureka, your tenilic idea. Invest time in tills sticky idea. 
Get your better half and the people you truly care about on board. 
Tliey give you t!ie energy you neetl when times get toiigli. 

'lb make a living out of it, it Is imjxmanl to the take the 
business side into account as well. In tlie next article, we will talk 
alxiut tlie Imsiness; The plan, ihe figures and the fun. 

Connect with us! 

We want to share stimulating, innovative kle^ts w^tth you and 
we really look forward to your feedl^ck! Is anytliing missing or do 
you iliink .sometfiing ojuld be fleshed out in ftinher detail? jusi let 
us know and w'rite to oliver.pospisif@inspjiiedby)ife.com. 
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Communication is the cornerstone of effective project 
management This is a principle that is clearly understood by 
most project management participants. Many times the most 
difficult portion of a project is effective communication of 
project object! veSy goals^ and desired outcomes of the project to 
team members. 

The more resources involved in attaining project goals, the 
more complex communication tasks become. ConceptDraw Office 
is able to dearly define and implement the communication 
processes for any project. 

With ConceptDraw Office, you can easily build long-lasting 
customer relationships, expedite project activities, and keep 
control over projects by delivering necessary information to 
responsible parties in the corresponding deadlines and in 
appropriate formats. 

As 9<yfo of a project manager's time is invested in 
communication, it is critical that there is a tool in place that 
best utilizes that time. A large portion of that is invested in 
daily communications, such as, project monitoring, coaching 
team members, modifying project details, and responding to 
information requests. 

Incorporating an effective communication strategy is a aire 
component to a project management team, to keep projects in 
line with the expectations of a company. Once a project strays 
off target it is very tedious to get it back on track. Many times 
project results can become mired in mediocrity because clear 
channels of communication were not properly setup from the 
very beginning. 

When implemented properly, a good communication process 
positively transfomns the entire project expenence for all 
participants. ConceptDraw Office addresses communication as 
a critical component that is vital to managing communication 
throughout the entire project life cycle 

There are five main components and stages of a project life 
cycle: 

1. Generate Ideas 

2. Plan Actions 

3. Organize the Project 

4. Communicate Strategy to the Team 

5. Manage Project Execution 
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Figure i. Components of a Ptojeef LUb Cycle. 


Before a new project reaches im pie men tat ion, there is a necessary 
stage of research, discussion, and creativity, t his Idea Stage is w'here 
project ideas are generated, selected, discussed and finalized. 

Ibc main issue facing pmjtrct managers at this .stage is the need 
tt> understand the main goal and Its requirements. Whether you are 
working on an internal or external project, there is alw-ays a need to 
discuss ideas and potential strategies, as project nesouice requimments 
must be calculated and understood amongst all preset partidpants. 

Mind maps are often used to present a ctimbination of ideas in a 
readily understood visual formal ConceptDraw' MINDMAP helps 
map out and organize ideas in this initial stage, in an effident manner 
that i.s appropriate for any project management workflow. A mind 
map IS an effective way to visually capture and present concepts, 
build strategy maps and assemble strategic action plans. Tlie intuitive 
user interface for brainstorming is an immeasurable value to any 
project. 
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Concx?plDraw MINDMAP also makes it simple to consolidate 
generated ideas and produce professional looking organizational 
diagrams. The suggested forms of communication at the Idea stage 
are brainstorm sessions^ mind maps^ business pmeess models, and 
presentations. 

The Plan Action Stage details the ideas, plans out the 
actions necessary for implementation, and forecasts the expected 
results of a project to higher management and investors. Precise 
organization and planning when creating draft timelines and 
budget are critical components for future projects. At the Plan 
Action and Organize Project Stages, a project timeline is 
mapped out for task and resource (people, equipment, and 
materials) allocation. Concept Draw Office contains the tools 
necessary to handle these tw'o important stages, 

ConceptDraw PROJECT is well integrated with ConceptDraw 
MTNDMAP, saving lots of time when setting up a project and all 
the other necessary components* The mind map created with 
ConceptDraw MINDMAP during the Idea stage, can easily be 
transformed into a project Gantt chart, simplifying job delegation 
and describing responsibilities, 

ConceptDraw PROJECT is also tightly integrated with 
ConceptDraw PRO, requiring just one click to automatically 
build a Work Breakdown Structure (WBS) chart for your project. 
Now it is easy to keep your WBS up to date. If more changes are 
needed, modifications to the project can be directly made in 
ConceptDraw Project with the automatic rebuild of associated 
WBS. 

ConceptDraw PROJECT also makes it easy to send detailed 
To-Do lists to all project participants. The typical amount of 
time it takes to communicate these tasks is significantly reduced 
to a minimum* 

Suggested forms of communication for the Plan Actions and 
Organize Project stages are Gantt charts, WBS charts, flowcharts. 
Network diagrams, and To-Do lists* 

two other major components necessary for the success of a 
project are Daily and Management Communication. Having 
a communication management strategy that is supported by 
ConceptDraw Office helps detail the needs and expectations of 
the team, how project data will be exchanged, and the 
responsibilities of each team member. Creating professional and 
impressive presentations of project data helps build company 
credibility with customers and stakeholders* 

The communication process continues as long as a project is 
in action, to keep information flowing between ail meml'>ers of a 
project. 

information flow is vital to a project, as it presents assigned 
tasks, reports results, and presents decision making data to 
project participants* Information flow connects all participants 
of a project, providing necessary information in a timely 
manner and in a format that is most appropriate for the tasks* 


ConceptDraw Office minimizes the amount of project rewc>rk 
necessary and Improves the everyday workflow of any project by 
utilizing visual methods to represent pertinent information and 
business processes* With visual methods it is easy to: 

• open paiject files in ConceptDraw MJNDMAP to modify 
schedules and project details 

• effectively determine workioad-to-work capacity and 
resource allocation in ConceptDraw PROJECT 

• present project status to clients and colleagues in the form 
of Report Maps or by utilizing Concx^ptDravv MINDMAP 
features such as Presentation mode and export to 
MS PowerPoint 

• build charts and diagrams in ConceptOraw PRO that 
document processes and reports on project status 



FigureZ. Visual Representation on Project Information. 

During a projecl life cycle dozens of documents are created for 
different purposes* ConceptDraw MINDMAP makes it convenient 
to keep all the related files to a project in one place* A single 
Knowledge Map, suppt^rting multiple pages and hyperlinks, easily 
becomes the main information source for a project of any size. 

Suggested communication formats for the Communicate and 
Manage stages are Report Maps, Resource Usage view, Visual 
Reports, Project Dashboard, Knowledge maps, mind maps, and 
ItowerPoint presentations. 

Gear communication within a company helps build a 
collaborative work environment, wito an emphasis on a shared 
vision of goals. ConceptDraw Office offers an effective and 
innovative approach to managing the five main amiponenLs and 
stages of a pix^jett life cycle* 

l^am more about ConceptDraw Office at: 

www*concep tdraw.com 






















by Sengag Baring-Gould 


In this article I present an extension to NSLog () which 
not only prints out a user specified message l>ur also lists the 
fund ion calls ihai led to its invocation. By llie end of this arlide 
you will have a new tool you can use in your own applications, 
and youH understand liow it works so that you can adapt it to 
y(mr needs. 

Why log? 

NSLog() is an importanl tool for debugging. It can l)e 
placed anywheie in an application to log internal state. 

Many programmers prefer logging to using a debugger, as 
it helps them concentrate t)n possible causes of a prt>blcm 
while filtering out irrelevant inlbniiation. Logging provides a 
complete textual record of the prt>blem tliat can be .studied 
later. 

Debuggers on ihe oiher hand imermpt the developer wlio 
tnust rectjrd by liand all the relevant state before letting the 
application continue. Cominiiing is an unforgiving operation: 
once performed, prior state that wa,s not recorded is lost. 

Brian W Kernighan (one of the authors of the seminal text 
on the C language) said: 

''As a personal choice, tend not io use debuggers ixyond 
gelling a stack trace or the mlue of a variable or timr One 
reason is that it easy to get lost in details of complicated data 
structures and control flow; tee find stepping through a lm}gnim 
less productiife than thinking harder and adding output 
statements and self-checking code at critical places^ Clicking 
over state?nents takes longer than scanning the output of 
judiciously filaced displays. It takes less iime to decide where to 
put print statements than to single-step to the critical section of 
code, even assuming iw know where that is. More imjmianl 
debugging statements stay with the program; d(^hugger sessions 
are transienr. 

However, if NSLog( ) 
is invoked from a fimerion 
that is called from many 
other functions, 

determining which function 
call caused the irug can be 
very difficult. We need a 


record of the function calls that lecl rti the tnvoetition of 
NSLog( ). 

Where we are headed 

Our new debug function debugLog() will print out any 
message we want the same way NSLogO diKs. Following the 
message, it will list the function invocations that led it lo be 
cilled (see Figure 1, below): 

The first line follows NSLog ()'s traditional format: the 
date, the time, the name of the application (I'estDebuglog) and 
then the inessage we passed as argument: "0++ Constructor", 

On the next lines, debugLog () lists the function 
invcK'ations that led it to be called: 

* debugLog ( ) was called from the C++ constructor 
CPP; :CPP() defined in TestDebugLog. 

* CPP:CPP{ ) was callefi by main aLs{> defined in 
IhstDebngkig, 

* main was called by start also defined in TestDebugLog. 
(start is the function the Operating System calls when it 
starts an application). 

I’he niiKlule name between parentheses specifies where a 
function is defined. In the following example, 
KSPopAutoreleasePool is ,shown to be defined in the 
Foundation fiamework fsee Figure 2, below): 

Obtaining the list of function 
invocations 

Obtaining the list of 
function invocations to print 
LS a two step process. First, 
debugLog () must obtain 
the addresses of the 
fijnetions that called it. A 
computer uses addres.ses to 


2009 04 05 15:37:58.119 TestDebu^og[ 14442:l0bl 

OH- constructor 

OOOOlDlf - CPP::CPP() + 33 

[TestDebugLog) 

00003 16 c - main + 86 

{T&stDebugLog) 

OCiOOi,-i5e - start > 54 

(TestDebugLog) 


Figure 1 
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2009-04 05 15r4Q:03.921 [14462:1Obi ObJectlvc C dealloc 

000030d5 [Objc deallocl + 33 

(TestDebugLog) 

9ni/e4£ - NSPopAutoreleasePool + 431 

(Foundation) 

OMOlldl - Min 4 207 

(TenDebugLog) 

00001fl4a - st*rt + 54 

(Test DebugLog) 


keep track of what il is doing, l)ui addresses are not specified 
in a program's source-code. 

'Ilien debugLog() miisr translate these addresses into the 
function names tfiai appear in die pmgrairfs source code. Three 
different nieilKKls are required to obtain C, C-I-+, and Objective* 
C function names. 

1. Retrieving the list of called iiinctions' 
addresses 

Compilers transform st>uac-code into machine code that 
computers understand. When a function Is called* the caller's 
return addres.s must be saved so that the CPU can continue 
running the ctaller after the functitin invoctilion completes. In 
die context of this discussion, we will assume that these leturn 
addresses are stored on the stack. (We will ignore specific 
optimizations used by the PowerPC and x86 CPUs). 

Unfortunately, the stack also records other information, 
such as local variables and bmetion arguments. Determining 
precisely which items in the stack are return addressees ret|uires 


compiler specific knowledge. Conveniently, the new version of 
gcc which ships with Leopard provides a new funedon, 
backtrace! )t which gives us the return addresses in the 
current stack* 

Remember that inlined hinaions are emlx;dded widiin 
their callers rather than iKang invoked. This means backtrace 
will not see tlieni in the stack and they will not be listed by 
debugLog(). 

2. Function layout in memory 

Functions are compiled independently by the compiler and 
occupy contiguous areas of memory. Ttiereforc if we know tlie 
starting addresses of any two consecutive runctions f and g* and 
if we liave an address x which falls between f and g ( < x < 

iig ), we know that x belongs to the function f. 

One rarely lias addresses tliat match the Ix^ginning of each 
functitin precisely. Therefore function-knikup functions are 
designed to return information about the preceding function 
when given an address. Our o-se matches iliis scenario: the 
return addresses provided by backtrace occur within fcmctions. 
Thus we can safely ignore the difference between return 
addresses and starting functitin addresses for nicxst of this 
discussion. Similarly, we’ll adopt the standard convention of 
referring to starting function addresses as hmetion addresses. 
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3. Retrieving C function names 

Wlien an application is first loaded into memory, it needs to l>e 
told the addresses of the external library functions it wants to 
use* Because libraries are updated independently of 
a[)plicatioas, the addresses of their functions may change, 
although the names of their Functions will not* It is the 
responsibility of the dynamic linker to give each application 
ihis in forma Li on. 

The dynamic linker reads function names from a symlK>! table 
eml>edded in the applicarif>n and the libraries the application 
uses. The syminjl table lists all the C function addresses and the 
C function names that can be accessed externally Therefore if 
we know an address, we can ask the dynamic linker for the 
corresponding function name. The baGktrace__syinbols () 
funcLitm provides tliis functionality. 

Because the dynamic linker only knows a[x>ui externally visible 
hinaion names, backtrace_symbols () always returns the 
nearest preceding external symlx)l Static C hinctions are not 
exported and will not l)e given the correct name by the linker. 
Most symbols will be exported as external if ytju compile your 
application in Debug Ct in figuration. This is not true if you 
compile it in Release Configuration. The UNiX utility nm lists 
exjxirted function names with a preceding c'apital T letting you 
check if an unexpected function name shows up, 

4. Retrieving Objective-C method names 

Ql')jective-C does not use the dynumit: linker. Instead it 
uses the Objective-C rtmiime, whicli like the dynamic linker 
keeps track of all known method addresses and names. (A 
method la a llinction defined within a class). Howewer iliere is 
no equivalent to backtrace_syinbols() which returns a 
function name when given a function address. We most build 
one (>unic‘lve.s, 

'fhe Objeciive-C runtime pnwides a funciitm to enumerate 
all the Objective-C clxsses tliat c'an be invoked by the 
application, including those in the frameworks fxnind to the 
application. It also provides a function to enumerate the 
methods in any Ohjective'C class. With tlie.se components we 
can ol>Uhn every methods address and name. 

Implementation 

This code is Objective-C++ so don't forget to use the ^mm" 
extension for your implementation filename. We start with the 
necessary includes: 

Debuglog Implemenmtion Fik: SBGDebng^mm 

iifinclude “SBGDebu&.h*" 

jfinclude <cxxabi.h> 

^include <Bap> 

^include <strin6> 

#include <execinfQ.h> 
include <stdio,b> 

^import <objc/Object.h> 
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We want to build a method-lookup function that wili 
return the meihod in which an address iies. We know how to 
eiiumemfe die name and address of every Objective-C method 
available to the application, but this enumeration is expensive, 
Tiierefore we need a data sinjcture in which to store the 
iocations of tlie meiniier functions. 

llie data structure must return the correa member 
function when queried with any address iielonging to that 
mcinlx.T function. NSDictionary dt)c\s not provide this 
functionality, but C++'s Standard lemplate Library's (STL) map 
container does. 

map:: upperebound reiurn.s an iterator to the first 
element in llie map whose key is larger than the queried key. 
For a map with method addresses as keys and method names 
as values, map:: upper_bouiid will return an iterator pointing 
to tlie name of the method following the one we are looking 
for. Simply decrementing the iterator will make it point to the 
preceding method name. 

/ / Lookup Function names 

static std::tnap<ulrit32. std;istring)* objectiveCMcthodXanMjs = NULL: 

Inline static ijint!i2 l<iokupl'urictionEulnt37. addr, const char** naraej 
( 

if CobjectlveCHethodNaraes = NULL) 
return NULL: 

/ / Find the next function 

std: :iiiap<uint32* std; ^string): riterator iter 

= objectlveCMethodNanes’>upper_houtid( addr ); 

II Go back a function: now we are looking at the right 

one! 

-iter: 

‘name = iter->second,c_str(): 
return iter >flrst: 

I 

Populating the STl. map is a simple matter of iterating 
llm)ugh all the cla,sses known to llie Objective-C runtime, and 
enumerating their methrxis, 

// Add classes by stepping through their method lists. 

inlinE static void addObjectiveCtfethod(ulnt32 addr, confft ebar* name) 

I C'objectivflCMethodNaraee) faddr] “ std;: lit ring (nanie): 1 

void addClassECIa^s c) 

I 

unaigned int method_coimt: 

Method *i]^ethod_liat = ciasa^oapyHethqdListtc. 6(method_coinit): 
for (Int 1 * 0; 1 < inethad^cmmt: 1+^) 

{ 

Method func " iiiothQd_list [i ] : 

const char^ name ^ sel_getNaoel method_getName( fmic ) ); 
uint32 addr =" {uint32) nothod^gDtrcnijleiiientatlotiE fmir )* 
addObjectiveCHethodC addr. 

[[NSSirlngsiringWith-' 

Format:#"pis Is]", 

claKs_geLHamo(c) * name]"* 

cStrlngl): 

1 
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We could call the code that enumerates the Objective-C 
metliods explicitly from main, but that requires remembering? 
to add the call to each new application that uses 
debugLog (). lastead I can put the enumeration code into 


the load method of an ObjecLive-C class which is guaranteed 
to Ik^ called if debugLog () is built into the application. T he 
only gotcha is that the load meihcxl is invoked before CtK’oa 
has created an KSAutoreleasePool. That's why the code in 
Figure 3 creates its own NSAutoreleasePool to avoid 
memory leaks. 

2. Deciding whether a function is C, 
C++ or Objective-C 

The rt'lum addresses provided by backtrace () could 
belong to a C function, a C++ fimction or an Objective- 
C method. We need a way to decide which case we’re 
dealing with. We start by asking both the C/C++ 
function-lookup function and the Objective-C method- 
lookup function to what function they believe a return 
address belongs. We will obtain wo addresses a and h 
which should both be smaller than the return address r. 
Because functions are contiguous and do not intersect 
with each other, a anti h must differ, and one of tltem 
must be lower than die other. For the same reason, the 
return address r cannot belong to rhe function with the 
lower address, as that function mus! end before the 
higher address. Therefore we use the name of the 
function that starts at the higher address (see Figure 4). 


dimpl&ntentation SBGD^bug 
+ (void) load 

t 

if (objectivfiCMethodMfimes I- JIULL) 
return: 

NSAutoreleasePciol* pool - | [NSAutoreleasePool alloc] Init]: 
objectlveCHethodtJataes “ new std: :map<uint32. std: :string>{); 

Int ntjmClasses = objc.getClassList(NULL* 0): 

Jf tnnmClefises > 0 ) 

r 

Cla^s ’classes - (Class’) mallocCsiseof(Class) ’ numClasses]: 
nuiClasses - obJc_getClassListCclassesH nunClasses): 

for (Int i “ 0; i < nirmClasses: ++ 1 ) 
addClass(cla$ses[l]); 

free(claGSes); 

) 

[pool release]: 

I 

@end 


Figure 5 
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extern "C" void debngLog{NSStrliig‘ foxmx, 

I 

/ / Print the debug message 

va_lisi argunentfi; 
va start(argunents«format); 

NSLogv {format, a r^vunents) ; 


/ / Dump the callstack 

ijint32 callstack{128]: 

Int fraiGs = backtrace({void**} callstack. 128); 

cha r * * St rs ^ backt race_synibo 1 s ({void * *) cal) s t ack. f r ames) i 

for (int i = 1: i < frames; ++1) 

( 

char functionSymboi[64*l024]; 
char modulcName {64*1024]: 

int offset = 0: 

sscanf Cstrs[i). "Vd %s %*s %£ %*s %d*, ^moduIcNante, 

SfunctionSymbol* ^offset): 

uint32 addr callstack[ij; 

if (objectlveCHethodKamas) 

i 

const char* objelfame: 

uint32 objcAddr “ lookupFanction(addr, tobjcNaie): 

if { (objcAddr 1= 0) 

kh Uddr > objcAddr) 

Uddr - objcAddr < offfict)) 

I printf [''\t%3.8x - Ifi i addr* objcName. 

addr ' objcAddr. 


moduleName): 
I; 


continue: 


int validCppName; 

char* ftmetionWame “ abi;:_exa deaiangle (fuiictionSynbol* 0* 

6valJ dCppNaiia); 

if (vaiidCppName D) 

printfC -\tX9.ax - %s + id\tU(xe)\n^* 

addr, functionNaao* offset* noduleName)* 

else 

printf( ""Ulta.fix - Ss + %dVt\t(%s)\n’'* 

addr, functionSyibol. offset* tnoduleName): 

if (runctionNarae) 

free(functionflame); 


free(sirs); 


The oiiipul t>f backtrace_symbols() is an array 
of C-strings. We use sscanf () to parse them. The 
resulting function names are passed to itie C++ 
demangler to convert into human-readable fonn if 
tlit 7 are C++ name*s. 

debugliOgC) uses print f{) rather than NSLog() 
to avoid printing the applicaiitm’s name at the 
ix'ginning of each line. 

debugLog{) is declared as extern "C" so it t^n 
be linked directly to Objective-C code. The class 
interfac e file dexs the *same: 

DebugLog Interface File: SBGDehug.h 

tinterface SBCDebug : KSObject 

+ (void) load; 

§end 

jiflfdef _cpltLspltis 

extern I 

#endif 

void debugkjafiiSStriOg* format. ...); 

Ififdef_cplusplufl 

h 

jfendif 

Using DebugLog 

Invoke debugLog() just as you would NSLog(): 

Test file: TestDebugLogMim 

ifimport "SBGDebug.h' 

// C+f test 

struct CPP 1 CPPf): ^CFP(): I: 

CPP;;CPP{) 1 debugLog(#"C+*- Constructor'^); h 
CPP:;*^PP{) ( debugLogC§''C+-f Oestmetor"); 1: 

/ / Objective C test 

^interface Objc * NSObject 
iend 

^implementation Objc 
- (Id) Inlt 

E debugLog{&"0bjective'C init"h return [super i.nit]: 

I: 

{void) deallpc 
f debugliOg(#"ObjeCtlve’C dealloc"]: {super dealloc]; 1: 

iend 

// Main 

Int main(ini arge* const char* atgvl]) 

( 

NSAutoreleasePool* pool = ([HSAutoreleasePool alloc] initi: 
GPP epp: 

Objc’ objc “ tttObje alloc] initi autorelease]: 


Fi^re 4 

debugLog(@“C — test arguments work too: X®'*, objc): 

[pool release]: 
tetum 0; 

1 

Conclusion 

lx*opard provides all the components neces,sary to build a 
cross-platform NSLog() which can print function call traces. 
Although the code I prt>vide assumes compilation to a 32-bit 
executable, extending it to 64 bits should he straightforward as 
only standard library functions are used. 
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Demystifying PKi 


Part One in a Series of Articles and How-Tos 
about PKI technology in the OS X environment 


By Michele (Mike) Hjorieifsson 




Introduction 

Public Key Infrastructure, or PKi, is a mature set of tools 
and teclinoiogies that serves as the basis for securing most 
network comniunications and dozens of odier security 
technologies, It is one of the most misunderstood technologies 
in ihe IT arena. This series of articles presents a brief history 
of PKI, explains how it's currently used, and describes how 
you can implement PKI in both small and large OS X 
implememations l()r various types of security without breaking 
tile bank or causing excessive brain strain. 

What is PKI and Why 
Should I care ? 

Let’s start at the beginning,. PKI lias evolved from a ilieoiy 
anti paper published in 1976 by Diffie-tlellman descril'Jing the 
use of asymnieiric ciphers versus symmetric ciphers in a white- 
pages-like directory where you could pull down or validate an 
individual’s public key. ’Ihis theory was initially pul into 
practice by a groufi of mathematicians from the Massachuset.s 
Institute of leclmology (MIT), namely Ronald L. Rivest, Adi 
Shamir, and Leonard M. Adleman, more popularly known as 
RSA. RSA’s premise was based on die understanding ihai when 
you multiply prime numbers together, diere is no easy way to 
reduce the product back to its source. And, the larger the 
number, the more difficult it is to reduce, making this technique 
ideal for cryptographic operations tliat eould be implemented to 
achieve Diffie-Helman's original and additional cryptography 
goals. Wow, M>unds very tecrhnical. Under the hoex! it is quite 
technical matheiiiatically hut here’s a more understanriable 
explanation. 

A symmetric key encryption .scheme requires two or more 
parties to have a shared key Think of this as a decxider ring you 
fmd in a box of cereal As long as all tlie required parties have 
the dectoder you can send encrypted messages back and forth to 
each Ollier secretly. The big question about symmetric keys is 
how do we get the decoder ring to everyone in a way that 
preventsS it from being compromised? Enter asymmetric key 
schemes that, in contrast, have two sets of keys, a private key 
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(your secret key) and a public key (something you send about). 
'ITie sender of a message u.ses your public key to encrypt or sign 
a piece of information and transmits it to you (we will get into 
the differences between encrypting and signing later). You use 
your private key to decrypt or verify tlie signature. Only the 
private key can decrypt making diis a pretty good system, and 
<|uiic secure. 

Now that we have a basic understanding of asymmetric 
keys, let’s talk about iiow this is implemented in today’s 
technologies that you are most definitely femlliar with. When 
you [)urchase an item at an online store you are normally 
diiected to a secure page indicated by an https URL in the 
address bar, commonly known a.s an SSL protected, or secure 
sockets proLecied web page. Without your knowledge, in most 
cases, your browser has a very fast conversation with the 
.server: the server presents its certificate; your brow^ser checks 
this certificate against a .set of ac'cepted root signing certificates 
it has preloaded; your browser either accepts the cerlifieate 
and starts an encrypted session or prompts you witli the 
following message indicating it doesn’t "trust” the certificate. 

A quick w<jrd about ’'trust’’. With Mac OS X Server and 
otlier operating systems, you can create a self-signed certificate 
that you generate yourself typically for internal use in your 
organization or on a test machine. Thi.s certificate in no way 
diminishes the encryption protection created between the 
browser and the server, 'fhe level of encryption is the same 
regardless of whether the certificate is publicly ”lrusled’’ or 
privately "trusted" (that is, generated by you on your Mac OS 
X Server). 'Ihls "trust" (and 1 put **(nxsC in quotes for a reason) 
is created by the browser manufacturers and a group of 
companies that have established certain procedures and 
security measures that make them "trusted" by your browser's 
manufaemrer and the public at large. 

Now you see that you have been using PKI for several 
years and may not have known it. PKI is the technology 
behind the certificate: how it’s generated; how it’s validated; 
and who is or is not trusted. 
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Let's take another item we are all familiar witli: a credit 
card. 1 assume anyone reading this article has at least one or 
more cards with either of tlie two major card issuer's logos on 
it. Why is tills card accepted at retailers and online stores 
worldwide? Why do they “trust” your card? Well, you applied 
for the card, the curd company verified your informalkm and 
tlien issued you a card with a unique number on it. They also 
have established a trust relationship with millions of vendors 
in both brick and mortar and online stores. This concept is 
quite similar to how PKI works. 

In the PKI worlds you ajiply for a cenificate to an KA 
(registration authority), the PA validates your information and, 
if valid, sends a recjucst to a CA (ccrtificalc authority) to is.siie 
you a certificate. This certificate has information about you, 
your organization and a serial number, just like a credit card 
cities. You receive the certificate and use it for one <if a myriad 
of potential uses .such as securing a website, signing email, 
signing documents, smartcard authentication, and perhaps 
opening a door at your office. When you use the certificate, a 
VA (validation authority), aka Online Cenificate Status 
Protocol tOeSP) responder, validates your certificate similar to 
the way your card is validated and checked against your 
available balance when yitu use your ejedit c:ard. Just like 
your credit card, your PKI cxTtificatc can have a PIN (personal 
identification number) assigned to it to lock or unlock it. 
Amazingly simple conceptually, yet, as you wall see, it is c|uite 
powerful and useful. 

So what can we do with these neat little certificates and 
how can we issue our own? for starters, almost all of the 
serv^ices pi ovided with Mac: OS X Ser\'er can be secured using 
SSfi also known as TIS (transport layer security). Tliese include 
iChat Server, iCal Sei-ver, Mail, OpenL>irectory, VPN Server, Web 
Server, and CoUaboratiQn Services (Wiki/BIog/Web Calendar). 
They all need a ceriificaie lo funiiion firojx.Tly. Additionally, 
you can secure access to your wireless thixiugh the MDIUS 
service and a technology knowm as 802.lx using a certific'ate to 
ensure only your users get on the wireless network, not just 
anyone iliat figured out some sluiR^d key that is probably on a 
post it note somewhere in your office. 

Yt>u probably weren't avv^are of tliis but Mac OS X Server 
automatically generates u self-signed setter certificate you can 
use for services during its install process, I hls certiflaite can 
he managed frrijn the Server Admin (oof by clsc'king on the 
Certificates icon. This is the most basic of certificate 
administration tools, Tlieie are several ways you can issue and 
manage certificates. For smaller environments, Apple provides 
die certificate assistant located in your 
/System/Library/Core Services folder. In next 
month's aiticle, we will delve into setting up your own 
certificate authority and issuing certificates using tills tool. 
Also, for larger inslallatioiis, tliere is an open source project 
called PJBCA (Knterprise Java Beans Cenificate Autliority) that 
offers both free community support and paid for corporate 
supiKirl and training. Tt> download and install HJBCA go to 
www.ejbca.org, Su[>port, training, and cusiomization are 
provided by PrimeKey Solutions (www.primekey.&e). EJBCA 
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will be described in detail in a liitiire article. For now, just take 
a look at your Mac OS X Server and play artiiind with the 
Certificate function to create some self-signed certificates and 
use them to re-st some services. Be careful not to delete the 
default certificate if it is already in use to prevent dismpting 
anyone’s ability to cormect to a given service. 

Conclusion 

So we have started down the wonderful road to pul:>lic 
key infrasmiciure (PKl), With this basic understanding under 
our belt, we can build our own certificate authorities, generate 
our own web and other certificates and learn how to use PKI 
for some pretty neat security functions like email and 
document signing* Till next month, stay secure and happy 
computing. 
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Sharepoint 101 


This ain’t your mother’s file server.” 

or, “What administrators need to know about 

Microsoft’s webified tool 

for working together”^ « 

by William Smith 


Moving away from 
ihe shoebox mentality 

Introduction 

Wliat <io iLsens in l>otli .smtill and large oigani/itiioas need to 
.share today? Menios. mail messages, piciiiTes, vidct> clips, sound 
bytes, documents, original files, derivative files, receipts, 
spreadsheets, presentations, diagnims and moie and more sluff. 

Small c'omfxmies and laige enier[irisc's fuive [)rogiessed well 
lx:ytjnd pieces of [Bper, manila file foklei^ and interoffice \^atiim 
tuites to storing data on centndized .ser\ei:s. Rut m'n wiih 
(xatiralizarion, a large server with a lerabyic or nK)rL* of storage 
space is essentially just a gig:iniic shoelx)x. Fulden? ane sitared and 
filled witli more folders and .siiMolders to organize everyiliing, 
r>ocuments and other elearonic files an" pbicai within iIkxsc 
folders and sulvfoldcrs. File .servers start as nice, neat, tjrg^inbxx:! 
shoeixjxes o( stuJf\iK.\i ewer time tiiase piles get disorganized and 
sc'^attered or die servers tliemselves get overfilled, nx [Hiring tlie 
purchase of yet m<Me sc‘rv'ers. 

MicTi^soIVs stiltidcjn to tlie slioelxix pnjhlem is SharePoint 
Server, a vimial Cilifbmia Closets for file .serv^ers, ShanT\)int Ls a 
ctmUml .system or, "CMS.” A CMS's job Ls to provide 

organizational stnicture witliin a server. Tills .simcture comes in the 
fomi of sejiarating document libmries from video libraries or ii 
comes in the form of separating financial data liom ctc’ative data. 
A good CMS will let yt}u do Ixjtli, letting you see tfte same 
infonmitioti presented in a variety of ways. 

SliarePoint is a web server presented to the eml-iLser ihnmgti 
any mcxiem bn)wser such as Fiielbx, Safari or Internet Explorer for 
Windows. It is designed to allow, ev^en mmitrajic, everyone to 
contiiixiie content to the site withoui having to know web design. 
It Ls designed ttj keep users wnihin llie Ixxmdaries of dieir sluiciKix 
areas Ux>. 

What can 1 do with SharePoint? 

A greal use ft>r SliarePoint is tmintaimng a comjxiny-wide 
Intranet site. Defxinments are as varied as they are plentiful and 
each wall liiive unique needs. Assume that well l>n>wsctx 


tluoughoLii tlie cxitiipany all default to an intranet webpage 
displaying company news, an address Ixxik and a talendar of 
events, "lliat webprage amid ilien .serve :ls a [xxtal for each 
deparlmenl such as Human Resources (HR), infonnation 
Technology (IT), Creative Service's ajicl Paciliries, just to name a few. 

1IR can provide its eniployet\s wiih act:cxs to employee forms, 
mediail leave balances and other infoniialion tliiougli its own 
SliarePoint site, whidi is a sulvsite of the ovenill Intranet website. 
Most of this content is static and doesn't change often but when it 
does have to change, one perMin within HR can Li[xJate the site 
hersc'If vviihoui having to know' any web axling. She can edit a 
jxige wiiliin tlie SharePoint wchfrage f>r choose ro download and 
Lxiii WtJid documents tfxtt have Ix'en posuxl. When the cliangcs are 
t'ompicte, she simply saves hcT changes or uploads the edited 
dt jcumeiiLs where tliey :ire immediately available to everyone 

rr Ixts a need to control its re(|ue.sts for new^ liardwarc^ and 
software. Rather than having users aril tlie Help IX'sk to ziiake 
these requests, lire iisscTs management gnmp can post forms on 
IT.s own sul>site of the Intranet site. Hie fonns can include 
requirexi fields such jts axsi center, approving manager, computer 
plallVirm, etc. Tliese fomis will not only reduce aills to tlie Help 
Desk but will ensure tliat all necessary information is Included in 
the request prior to submission. .Suhniiiiing the Ibnn can trigger an 
automatic E-mail message to tlie FT* assets niaruigement group, 
which can review the requests and place the orders. 

Creiitwe Services often nxTeives requests fnmi HR, Marketing, 
Sales and other groups for cxmipany logtxs. Some groujis need tlie 
logos in color wliile other gioups need black ^ white and st>me 
groups need logos in Ei^S fbmxil for print wliile other groups need 
JPEGs for w'ebsites. Tlie Creattvt* Dtrexlor can include these image 
files on its SharePoini sile, again a sii!>site of tlie Intranet website, 
along w'itli directioas for use and a stem warning against stretching 
and distorting. If a Sales user needs a color TIFF file witli a 
Windows preview fur a PowerPoint presentation but one doesn't 
exLst, tlien he can znake the request by ctimpleting an online fomi. 
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With Parallels® Desktop 3.0 for Mac, you can: 
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Facilities is in chai^ge of tliis year’s company picnic and recalls 
liiut CTiiployccs didn't care tor Iasi yeafs ciioicc of ](x:ntion. Platining 
well in advance, tliey decide to post a survey listing tliree choices 
rliat fall witliin budget. 'Ihis year die employees get to choose 
wlieiher they'd like an outdoor pic:nic at a local park, an ind<x)r 
buffet at a local game venue or a softM tournament at an outdoor 
reaeation complex. Hyperlinks to each venue’s external website are 
av'ailalile to assist in decision-making. Tlie results of ilie survey are 
immediately and autoinatiaiHy available to die Facilities group at 
any time during the surv^ey or when the .survey Ls complete. 

SharePoint can even be used as a cusiomerdadng external 
wdisite. Bc-cause SliarcPoint is delivered to die end-user via a wei> 
brov^^r, aodiing dictates diat it cannot be used outside of a 
company network. With some customization using the free 
SharePoint Designer tcx)l, a SharePoint site d(x^sn’l liavc to kx>k like 
a default SliarePoint site. 

Enhanced file sharing 

SharcPoinl Is not a complete replacement for file sharing 
servers but it is ideal for piotecting the integrity of files. 

Assume the Finance depiirtment prcxkices a spreadsheet with 
(juarteriy results and that several deixirtmcnt heads must approve. 
Tlie Finance Director had a difficult time finding a secure loaition 
on die company file server diat all necessary users could access but 
that re.strictcd uca^ for everyone else. Eventual I y, he tesorted to 
using E-mail, wliidi was not only insecure but allowed each 
department head to make ckinges diiec'dy in the spreadsheet, 
re^sulfing in multiple versions. 

Using SharePoint, the Finance Directtir can uplo^id iJic file to 
a secure wdisite piotected using Seaire Sockets Layer (SSL). He 
cm then as^sign reviewer pemiissioas to the dfx.'umenr for only 
those who need to see it. No one else in the company has access. 
Fuiihcnnorc. those reviewing die documail can add coniiiients but 
cannot change the content. Once reviewed and approved, he cun 
keep the ckKument available online for hi.stodcal purpexses. 

Replacing Exchange public folders 

According to Microsoft, ShamPoint is the replacement for 
[lublic Ibidem, a leatuie ihai was dc-cmpkisized in Exchange 
Server 2(X)7 and is losing ground going foiward in Exchange Server 
2010. Public Folders enable users to share maif calendars, contacLs, 
tasks, notes and documcnls with each odier diixRigh Oudook, 
Microsoft's E-mail appliaition fur Windows. Entounige, however, 
Microsoft's E-mail client For Macintosh is limited to just mail, 
calendars and conmets. 

Tlie likelihtxxl of Entourage ever sup}X)rting more witli public 
folders tlian it doe.s mm Ls practically nil. Furtliennore, by moving 
these items from a mail server to a SharePoint server, mail 
aclminlstralcxrs will not lx; tasked widi supporting file sliming witliin 
C-maiL 

SharePoint for your company 
or just for you 

Mac users who work in a Windows world may already have 
SharePoint .services available witliin dieir company or at least have 
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Lhc infrastnicLure: ncx:es,sary to implement ShiirePoint at an 
enterpnse level. However, smaller organt:atioas and even 
inciividiiaLs witli liinitecl resources Iwe optioas tc)r getting 
SharePoint t(K> and for very reasonable prit:es. 

For individuals and small organizatioas without a server 
budget, online service providers offer Sharel\)inT services over the 
TnLemel. This is known as""SharePoint hosting", Prit:ing starts as low 
as S10.{X) per montli for ui> to 500Mb of storage space with 
unlimited users and includes 24/7 support. Plenty of hosting 
.services offer 30<lay free trials for you to evaluate SharePoint for 
ytmr own needs. 

For those larger organizations where IF has been brought in- 
house and is supported either foil-time or part-time, tlien Microsoft 
Small Busincfxs Server (SBS) may fill ifieir needs. SES is an alFin-one 
Windows Server produa tliat offers not only file and printer sliaring 
but SharePoint, remote connectivity and Exchange for E-mail. Rill 
SliarePoini .services are provided wiili SBS, liowever, enterprise- 
level options like SharePoint farm servers aren't avaffable. Tliis 
produa really is intended for '‘smaU business”. 

SharePoint .Server can be viiTualized. Mac shops that want ffie 
feature set of SharePoint but want to utilize tJteir existing XServe 
infrastnioiire may want to consider running SharePoint on hare- 
metal virtualization.. A newer Intel XServe with l^eefy timounts of 
RAM and processing power cm run multiple Mac OS X and 
Windows virtual machines. Microsoft offers a 32-liit trial ven^ion and 
a 64-hit trial version directly ft'om their website tor testing, 

Microsoft itself offers Office live Workspace online, which is 
very similar to SharePoint in the way it functions. It is currently in 
l:Kfta but open to the public for free with up to 5GB of space for 
.storage. Office Live Workspace am ix* used for Ixith wwk and 


lionic and it and offers many tenifilates for craiting a shared space 
quickly and easily. It is available at littp//warkspace.officelive.com. 

Moving into a SharePoint site 

Out of the box 

Once SliarePoint lus been installed, tile administrator must set 
up the first site. U.sually, tills is a site based on one of four groups 
of templates, which come pre-installed for various team sites. Figure 
1 shows tiie default Team template from tlie Collalxiration set of 
templates, It comes pre-p(.)pulated with placeholder information. 



Figure 1. Default Team template from 
the Collaboration set of templates 
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We're Easier. 


In fact, REALbasic is the easiest, fastest way to create software for Mac OS X, Windows 
and Linux. 

Why use REALbasic? Use REALbasic to create software that solves a problem, automates 
a task, or unleashes your creativity. Use REALbasic to create software for your own 
use, to share with your friends and family, or even to start your own software empire. 

With REALbasic, simply drag-and-drop to build your interface, then add code that makes 
your interface work. REALbasic has online help, tips and auto-complete to guide you as 
you go. And if you do need help, our online community of thousands of users is here to 
answer your questions, 24x7, 

You start with an idea, the rest is easy. With REALbasic. 



For a limited time, getting REALbasic is easier too. 

Get 15% off when you buy a new REALbasic license. 

To get the discount, go to www.realsoftware.com/mactech 
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llie defiiult webpage \s divicted into sevenil sections: 

A) Top link bar - Includes the name given to liie site during setup, 
aser links, navigation tal>s ajid seartit. 

B) Login and p^sonalization - /Vllows users to change ^accounts, 
log out and aistomize tlie appearance (jf die site for ilicir own 
neetis, 

C) Site Actions menu - The site owner wiU see this menu, allow^ing 
him to aistomize tlie appearance <,>f tlie site a.s well as die 
slniaure of the tx>ntimL He can make diLs menu uiiiivailable for 
general vLsitois. 

D) Site Image - Hie site owner can apply a aistom graphic for 
personalization. 

E) Riglii Zone - Hie light coluim or ‘'zone’' of tlie site, 

F) Left Zone - Hie left zone of die sice. 

G) Quick Launch bar - A navig'ation brir for browsing the site. 

Site Actions menu 

^tie Site Actions menu is piribably the most important menu 
for a site owmen It is used to mexlify tlie entiie site from simple 
name changes to mcKleraie page layout to complex navigational 
links. Only the site owner and anyone he allows will see this meniL 
Otherwise, anyone visiting the site will see it as tlie site owner has 
chosen to present it. 


“ 

Create 

ttt-i 

Add a new libraryjf iistj, or web pa^e 
to this website. 

t'—• 

Edit Page 


Add, rerrmc, or update Web Parts cm 


this page. 

m 

Site Settings ^ | 

Marage site settmgs m this site. ^ j 




Figure 2. Site Actions menu 


Fmm tlie Site Actions menu die site owner am select the Site 
Settings command to control read/write access to the site. He can 
also adjust the kx)k and fed of the site by changing die Tide, site 
dteme and Quick Launch navigation bar ant! he can even save his 
new Itx^k as a template. Ihe Site Settings page is w^here die site 
owner can add Web l^arts (more on ihcxse in a minute) to die 
ciinent page os well os apjily njgioniil settings .such as die cuireni 
time zone, date ^ time appearance and workweek days and h{.)uts. 
Hie site owner am twn delete the site itself from this page. 


Parts is parts 

What makes SharePoint easy for enthasci?^ How^ can one 
depiirtmenl aistomize SlianrPoint for its needs wltde another 
department is customizing SlxireFoint for iLs completely different 
needs? Ihe answer is mmkikmty’or what ShanToinl tails Web Farts. 

SliarePoint incluck^s more diiui 30 Web Paits that can be 
iiminged on a page in hundreds of ways. Web Parts include 
Linnouncements, calendars, links, tasks, team discussions and 
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Seapine ALM solutions 

for serious Mac OS X development 

Stay on track with Seapine's Mac OS X-native development tools. Designed for the most demanding software 
development environments, Seapine's Mac OS X-native application lifecycle management (ALM) solutions are scalable, 
feature rich, team-based tools that can be used separately for superior issue tracking, test case management, and software 
configuration management-or seamlessly integrated for more efficient control of your software development process. 


TestTrack Pro 
Issue & Defect Management 

• Track defects, change requests, feature 
requests, and other project-related issues. 

• Tailorworkflows, including events, states, 
and transitions, to your development 
process. 

• Stay informed and on track with flexible 
reports, email notifications, and 
escalation rules. 

• Create and link defects with failed test 
runs in TestTrack TCM for better 
traceability. 

• Link defects and change requests to 
source code changes in Surround SCM 
and other SCM tools. 


TestTrack TCM 
Test Case Planning & Tracking 

• Manage thousands of test cases, select 
sets of tests to run against builds, and 
process the pass/fail results using your 
development workflow. 

• Ensure all steps are executed, and in the 
same order, for more consistent testing. 

• Know instantly which test cases have 
been executed, what your coverage is 
and how much testing remains. 

• Track test case execution times to more 
accurately estimate the time required to 
test applications. 


Surround SCM 
Configuration Management 

• Control who changes source files, and 
track what has changed and when. 

• Leverage file-level workflow to track and 
manage the state of individual files. 

• Facilitate parallel development with 
advanced virtual branching, private 
branches, and workflows. 

• Notify team members of new files, 
assignments, and changes by email. 

• Quickly access the latest files with 
shadow folders, hyperlinks, and Finder 
integration. 

% Seapine Software' 





TestTrack^ Pro TestTrack^ TCM TestTrack'Studio Surround SCM" Seapine CM' QA Wizard* Pro 

Issue Management Test Case Management Test Planning & Tracking Configuration Management Change Management Automated Testing 





shared documents to name a Each Web l^rt is a mini 
appliaition dedicated to just one function on a Sh;irePoint site. By 
arranging varirxjs Web I^ns on a page* the site owner on create a 
caistom portal tliat can Ix! as complex or as basic as Ire cIkxjscs. 
Wei^ Parts can lx? pbc^l in the left xone or the right zone of tiie 
jragc, can l>e resized and indude as much or as little detail as 
needed. This is ruminiscent of well-known Internet (x>rtal wef>sites 
such as iGoogte or Windows Live, 


Customizing Web Parts 

The Site Acttons menu also leads to die Edit Page armmand* 
which the site owner or anyone fie allows can use to mcxlify tlie 
layout or Web Pan content of each page witliin tite site. Wliile in 
SharePoint's Edit Mtxle, the editable portions of die page are 
highlighted and tlie Left ;ind Right stations of the page display Add 
a Web Part buttons. 


Figure 3. Site Settings 







TechRestoi’e 


help is on the way/j 


Electronics Parts, Repairs & Upgrades 

Overnight - Nationwide 

• Bulk Pricing Available ^ 

• Fast Friendly Service 



1-888-64-RESTORE 
(1-838^647-3786) 
8am - 5pm Pacific M - F 

techrestore.com 


MacBook & MacBook Pro 
Original LCD Replacements 
Start At Just $119 


Thousands Of Parts In Stock! 
Mac Laptop, iPad, iPhone 
And Sony PSP 


Mac Laptop 
Superdrives From $49 


Laptop • iPod • iPhone • Mac mini 
X-^ox 360 • PSP • PS3 • Wii • OS 



• Affiliate Commissions 

■ Reseller Accounts 

■ Volume Parts Sales 

• Blind Drop Shipments 

• Transparent Back-End Repairs 

• Customer Referral Numbers 

Call 1-888-647-3786 Today For Our 
Wholesale Parts List Or e-Mail 
sales@techrestore.com 



iPod Screens From $12 
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The MacTech DVD - Volumes 1.01-24.12 is packed with more than ever before -- 
almost 3100 articles from more than 280 issues (1984 - 2008) written by over 850 
experts, all 29 issues of Apple's develop, 21 issues of Frameworks magazine, 

100+ MB of source code, MacTech Viewer, working applications, full 
documentation, demos for techs, and more! The latest version includes 
all kinds of third party applications, videos, and demos. 


Everything Is displayed in the very fast, 
very searchable MacTech Viewer! An application that 
has been designed specifically with Techs In mind. 
Search quickly through almost 25 years of of great 
information provided by MacTech. Information to 
save you time, and make your life easier 



Requires Mac OS X v* 10.4.5 or later 


MAcnai 


fSfc 



NEW 

VERSION! 


^ AppleScript Essentials 

introdiKtlon to ScrlptlnB FHoHak«r 


m ■tK X ifl.-i n) 


Toll Free 877-MACTECH, Outside US/Canada: 805-494-9797 • http://www.mactech.com/dvd/ 






























(A q{mk note about web browsers; 

While the mtne SbareHoint site in 

hUmwt Explorer for Windom arid Safari 
for Mac should look similar, they win not 
cdu)ctys he the same. IE for Witidom is 
conskiereci a hevd 1 hnneser, whkh means 
it can mhe udtmnage of ail the bmwser 
features suplxirted by SharePoint. In 
parlictilar, IE for Windom can take 
adimitage ofActkeX coniwis allomng tbe 
user to uieu^^ motv infomuition and even 
drag ami drop Web Parts during 
arrangement. Firefox and Safari are 
considered Letel 2 broemrs. Ail of the 
functionaiity is present hut Just not 
£iccessihle in the sanuf UJt^. Other brousers 
may u^ork hut are not supported.) 

To the right of the lltle of etich Web 
Fart m: two buUuns. Tfie first iiutton is die 
Edit button. Clicking diis button displays 
the properties for tli;U [Wticular Wd) Part 
in a tempcrary pane to the right of the 
web page, ('licking ifie Edit button for the 
Site Iniiige Web Part, for exaniplc, displays 
the Site lm;ige properties such ;is die pa\li lo die image file, AkI’ 
text, alignment, appearance, layrxit and moie. 

For the most |rait, die alirihuies of every Web Part are die 
same, 'these attributes define die Zone or location of ihe Wdi Part 
on the page (left or KigliO, its order witliin die Zone or Zone Index, 


the Web Parfs Tide, who can see the 
parrinilar Web l-*art, etc. 

The set:oad fnitton next to the Tide of 
each Wei) Part is the Close button, which 
removes the Web Part from the page. 

Templates 

Deciding w'hich Web Pans to use and 
how to arrange them can lie a daunting task, 
sfj Micnasoft lias pre-popiilated SliarePoint 
with several default teniplatcs, arranged wadi 
viirious Well Parts, and diey offer move free 
LeiTipkiies for download from their website. 
Tile default teitit>taLe.s are grouped into four 
categories^ 

• Col labor ition 

• Meetings 

• Enterprise 

• PublLshing 

Tlie Collaboration set of templates 
includes a Team wdisiie, which Is ideal for 
a group of pet)]>le neetiing to sham 
duaiments and infoniiation. They also 
include templak^s for a Wiki, Blog and for 

Dcxiiments. 

Tile Mceiings set of templates includes a Ixisic template for 
nianaging agendas, attendees and ckxuments as well as moie 
specialized templates such as a lXx.ision Metning template for 
recording decisions and cmating tasks. 


Site Imude 

lm£igG 

Image Link 

To link to an Image flte, type a URL or 
path. 

Test Link 

/_! ay oiifes/imag e s/ho mepage, 

Ailern&tive Text 
Microsoft Windows SharePoin 

Image Vertical Alignment 
i Middle " i: 1 :| 

Image Horianntal Alignment 
f Center 

Web Part Background Color | 

transparent | 

+ Appearance 
*1 Layout 

. +1 Advanced ' 

I- 

Figure 5. Site Itttage properties 


MacResource 
Computers & Service 

Your 

iMac / eMac / Laptop 
Xserve A Power Mac 
Resource 


Parts, Parts, Parts 

We ktve a sggpiv of cisaetiG parts far iKae, W 
G5 eMac, etc. tCD oaneff fG4/GS iUacs, 

nUCBoohs andDisplavG. 


Logic Boards 

G3/G4 POI/AGP: $59 
G4 Gigabil/DigAudio: $99 
G4 Quicksilver: $199 
G4 MDD: $259 
G4 eMac; Irom $99 
G4 iMac: from $199 
G5 iMac: from $299 



Intel iMac; from $499 
G5 tower: $299/399/599 
G4 Xserve: $149-$299 
G5 Xserve: from $599 



Power Supplies 
G4 iMac 15/17/20*: $49/79/99 
GS iMac 17/20*’: $99/129 


G5 Tower: $169/199 


G4 Quicks!Iver/DigAudio; $179 
G4 MDD: $299 

Logic board/power supplies 
require exchange 



Processors 

Processors for G4, G5. Xserve 
G4 466/733/aOOyHz: $49/149/199 
G51 6/1.8GHz: $199/299 
Dual Processors (per module): 
1.8/2.0/2.3GHz: $299/349/449 
2.5DP/QP: $499/799 

Xserve Processors 
G4 133GHz DP; $189 
G5 2.0/2.3GHz:$l99/599 
Systems 

G5 16/1, BGHz $599/699 
G5 1.8/2.0GHZ DP $799/899 
G5 2.3/2,7GHz DP $999/1099 
G5 2.5GHz Quad Dual DVI $1499 
Intel 2.66/3,06 GHz. MaePro $1499/1799 
White Intel iMacsIl! 
CO/C2D 183GHZ 17** $599/649 
CD/C2D2.0GHZ17'* $649/699 
CD/C2D 2.0GHZ 20" $699/799 
C2D 2,16GHZ 20^/24* $829/999 
C2D 2.16GHZ /24" W/Leopard $1099 

Need G5 iMacs? 

G5 1.6/1.8/1.9GHz 17" $399/499/599 
G5 l8/2.0/2,1GHz 20** $459/569/599 
AirPort Cards 
Standard/Extreme: $69 99 
802.11 N Upgrades $79,99 
Bluetooth Upgrade $39.99/59.99/79.99 

1 -888-Mac-Resource 
www.mac-resource. com 


New Systems Arriving Daiiyl Call For 
Latest Stock . 

eMacs GALORE, GREAT 
WORKSTATIONS! 

700MHZ/256MB/4CX3B/CD: $129 
10GHzj^56MB/40GB/CD: $199 

We Have G5 Xserves & RAIDS 
Even if Apple DoesnTlII! 

G5 Xserve Cluster Node: $999 
G5 Xserve Full Unit: $1399 
1TB Xserve RAID from $2899 
2.8T8 Xserve RAID from $4699 
5,6TB Xserve RAID from $5499 
3.5/7.0TB Xserve RAID: $4899/6299 
We also carry FibreChannel Cards, Driv^ 
Controller Modules, Power Supplies,. 
Overnight Service 
Available!!!! 

Refurbished Displays 
Aluminum 

20/23 Cinema(DVI): $299/599 
30 Ctnema(DVI); $999 

Crystal 

22/23" Qnema(ADC): $249/299 
15" Studio LCD(ADC); $49 
17" Studio LCD(ADC): $99 
ir Studio CRT ADCA/GA: $49,99 
All Products are refurbished or 
demo call for more Information. 
























ror your enrire 
organization. 




Now 


Up to Dote* and Contact'5 

Calendor and Contact Software for Business, Groups, Families and You. 



fs this project on schedule? When ore you ovoiloble to meet about the systefns 
upgrade? Where ore all the field techs iodoy? When wos the last time anyone talked 
to our biggest customer? 

Virtually oil groups live (or die) by their abilities to meet deadlines and keep track of 
their customers, prospects, ond vendors. Few small companies or even departments 
of big companies hove the tools they need. 

Now UptO'Date & Contact might just be the calendar and contact software for you. 
It's time-tested and used by more Mac4DQsed componies than any other solution. And 
it's cross-plotform-avoibble for your PC users, too. Ifs easy to install and manage and 
simple for your employees to understand and use. 

Using Now Up-to-Dote & Contact you can schedule meetings for multiple users, view 
multiple, simultaneous calendars, and reserve rooms and resources. You can shore 
contact information about your customers, prospects and vendors* And using our free 
server softwore you con set it up in minutes and shore with users in the office or from 
anywhere with on internet connection. 


N0W 

SOFTWARE 


p- ^ 

Call us now at 866-52T-0556 or emoil us at mactech^nowsoftware.com 
ond weMf send you our free evaluation kit, including the book that will 
moke it oil easy, 'Toke Control of Now Up-to-Dote & ConfocT' from 

! 

Phone: 866-527-0556 ' 

Take Control books! 

■■ ■■■■ • ■■ _ ■ __ • ■ 


Web: WWW,now5offware.com 


Copyriglil © by Now Sctiwarfl, fnc. All fighhi re^iorvod. Now Up4o-E>ale ond How Cofiloel oro Iradvmorltt of Now Softwow, Ino- Moc ood Ihe Moo logo airo Iradoniarlii of Apple CtMnpuler, Inc., 

f«giM«r«d in ttw U.S. ond odior coonrriei, AN ofNpr irodemqrb acknci^edgod. 














RECOVER IN A FLASH 


Oata Recovary Sarvtcfls 

Toll Free Support 


Award WinnliiQ Software 


LC TECHNOLOGY 

^1 r L It IV A T 1 O N A 1 


wwwlC-Tech.com/offers | 

(666)603-2195 



DKODGEQ 

li 

5 Dynamic AUocotion T>1 
Up to 16 Business Lines 
Unlimited Local Service 
Unlimited Site to Site Colling 
2,000 Minutes of long Distance 
or Toll Free 


Voice Mail, Call Forwarding, 3-Way Colling, Call Hold, 
Pickup and Transfer, Call Waiting, Last Number 
Redial, DID, and DOD, Caller ID and more! 

www.loweostdialing,€oni 

800 - 906-8686 


Tlic Enterprise templates are for larger scale sites such as a 
Documents Center and a Recx)icis CcnicT. A Site Directory template 
is available to set up die Intranet home page mentioned earlier. 
This is ideal for listing otlier sites in your oiganizaiion and e\^n 
includes a toj) sites feature as well as a site map. 

Finally, the Pul^lisliing templates include an Intranet fxirtil for 
internal site management, including search features, as well as an 
external or IntemeL’-fadng set of pages. Fxtemal sit^ are expected 
to ha\e many readers on tite out-side of the oiganization %viLh 
content producers residing on the inside of the orgiinization. 

Blank site templates are included as well for diose who want 
to start their SharePoint sites from scratch. 

Putting away the dishes 

Content 

So far, everything has lieen about the laymit, look and feel of 
die SliarePoint .site. Wliat alxjut cxmtenc^ SfiarePrHni can hold mcJSl 
any type of file or data but how am it help its visitors find diose 
items? 

On die Home page just lielow the Home button is the Quick 
Liiinch bar. "Ihis is SharePoint's custoniUabte navigation tool and 
the door to putting stuff into it. 'llie very fin^t link is View All Site 
Content. TliLs link Iwids to a sort of .site map and displays all the 
Document Libraries, Picture Libraries, lists, Di.scus.sion,s, Surveys 
and other Sites within tills site. 

Wiih an ovaview of eveiything in the site, this is the perfect 
filacc to cTL'ate new Uf?mrk*s, which are simply collectioas of files. 
SharePoint olTers Libraries for different iVfXAs of file's. A Dexument 
Library Is suited for files tliat miisl l.x^ downloaded and viewed in 
the appropriate application. 'Ihis includes Microsoft Office 
dixaimeiiLs such Word and Exc el files. A Picture Library Ls suited tor 
displaying information such :is picture file size and c^'en a 
pRwiew for JPEG, TIKE and other graphic files. A Slide Library is 
.siKcific to prc'scntaiion ly|x.' files such as l^iwerl^oint or Keynote. 



Figure 6. AH Site Content 
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Network, Server 
and Appliance Monitoring. 

For Mac OS X 









Xserve (Intel & G 5 ) 


Xserve RAID 


Airport 


Lithium Network Monitoring Platform 

Lithium can now monitor your Xserve, Xserve RAID, 
Qlogic switches, Airports, Mac OS X Server... 
and everything else in your network. 


www.lithiumcorp.com 
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Wliile the default .settings are jasi fine for mcxsi each 
Ubnuy can be extensively aistomizecl to share even more 
information about its contents. For example, assume tlie Shared 
I>x:ufnenLs library a>n!ain,s a Word dcxaiment with a filename 
“Fiscal Year 2009 Siiminary^" which apjjcars in a list of 20 
documents. It also has an autlior, a creation date iincl a He type 
(MicTosofl Word file) that each appear in .separate columns. By 
default, these are die only columns of infonnation tiic site visitor will 
see* 


Rscal Year 2009 Summary 



^009 Summary 


chart Is missing* Have Creative d< 
on cover page. 


Figure 10. Modified metadata fields 


jTs^ 

Name 

Modified 

HodtfMBy 

pa 

Fiscal Year 2(109 

4/25/2009 9:29 PM 

MaftyMoo&e 1 


Figure 7. Default Docunient Library columns 


By selecting the Create Column coniniand from die Settings 
menu, the site owner can add columns to die list. 

Assume the sile owner lias added a Staais held with diree 
options (New, Reiiew And Complelc) that can Ixr .selected when the 
document is uplcxtded to the site or after it is already uploaded. 
This will allcw the site visitor to sort the columns by Staais to 
bubble-up all ihe dtxrumenLs marked for “Keview': 


Note that not all information thafs included about a file has to 
necessarily lx? visilile in a column. If die name of ihe file and iLs 
1 itle aie essentially die same then die site owner may choose to 
simply not display the 'Fide column. But what if information is 
valuable to .some visitors but not to others? Under the Settings 
menu is also a Create View command (see Figure 9). The site 
owner or anyone he allows can selea this command to display 
iillemate views of this information. 

Assume dial the Creative Services group maintains a Picture 
Library for odier departments to use. The Web .Services department 
ne<|uire.s 72 DPI JPEG images whereas the Print .Services department 
lequires 300 DPI TIFF images. Radicr dian cieaLe and maintain two 
separate Uiirarie^, die Cieative Seivices group can simply create 
one view aided "Web'" and another view called “Print" Visitors to 
the .site tun .select the view of their choice (see Figure 12). 


"Sidings V '7 



wmmm 


Create Column 

Add 3 cirfumn to store additiona I 
information about each item. 

Create View 

Create a view to sele?ct columns, 
fdters, ard other display settings. 

Document Library Settings 

Manage settings such as permissiorts^ 
columns, views, and policy. 


Figure 8. Document Library Settings 


Type Name Moriiffescl Mocitfted 

® Rscal Year 4/25/2009 9:29 pm Many Moose Review 

2009 Summary 


Creative > Picture Utarary 


Picture library 



Figure 11. Custom lecture Library 


Figure 9 . Modified Document Library columns 


Even more content 


Qilumns can display data from a variety of input options such 
as .single-line fields of text, multi-line fields of text, niimlx?r fields, 
drop-clown menus, checklioxes, radio buttons and even 
calculations liased on other fields or pieties of information. When 
a contributor upkrads his file he will fx? presented with a page to 
enter all the metadata about die file. 


Widi libraries of documents, photos and slides widi a wiki and 
a couple of blogs thrown in for gcx>d measure, how cun so much 
infonnation keep Ifom lx?eoming anodier shoelx)x of stuff? The 
aasw^r may be more sites’ 

Not only are web pages mociiiiar hut so too are sites. 
ShuJt‘Point Ls an excellent choice for creating an Intranet beiuu.se it 
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Help 

Has 
Arrived 


Web Help Desk 

Powerful Software for Service Management 


/ On-Demand or On-Premise Plans 
/ Incident & Problem Management 
/ E-Mail to Ticket Conversion 
/ Asset & Inventory Management 
/ Knowledge-base & Self-Help 


/ LDAP / AD Synchronization 
/ Customer Service Web Portal 
/ Approval & Change Workflow 
/ Performance Reporting Features 
/ Customer Satisfaction Surveys 





Mac 

diifwnil 





MySQL. 

ORACLe 

SQLServer 


Save 10% • Special Code: MTM0109 * Contact sales for details 


www.webhelpdesk.com • 1-877-943-0008 • sales@webhelpdesk.com 


Copynght O 2009 Studio UX. All Rights Reserved. Logos are registered trademarks or trademarks of their respecUve organisations. In the U S. andAcir other courrtnos 












Get your .COM 
or any other 
domain name 
here! 

FREE with every domain: 

FREE! Starter Web Page 
FREE! Getting Started Guide 
FREE! Complete Email 
FREE! Change of Registration 
FREE! Parked Page w/ Domain 
FREE! Domain Name Locking 
FREE! Status Alert 
FREE! Total DNS Control 

Just visit 

www.mactechdomams.com 

to register for your domain today! 




when a non-domain name product 
is purchased. Limitations apply. 


r^n contain sites within sites within sites. Responsihiliiy for 
niaiiiiiiinijig eacli site can \x: delcgaicd to mcmJx:is of each grOLip 
so tliat ajntent can l^e published as quickly as possible and 
maintained by many users mther than just a few. 

Assume tlie FT department is made of several smaller groups: 
Application Management, Development, Help Desk, Project 
iVhinagemem, Server Management and Workstation M^inagemenr. 
Each has a need to publish and maintain iLs own dcx:umentatic5nj 
scmie i>nvate and sonic pul)lk\ For example, the F!dp Desk has a 
need to publish fbmis for hardwire and software requests while 
the Project Management group has a need to maintain tasks and 
tinielincs. 

By revisiting the View All Site Content link again in the Quick 
Launch bar, die site owner can click the Create l:>utton and instead 
of creating a new library or IJst, he can tjcaie a new sul)-site. He 
can create one for each group witliin IT and their sites w'ill now 
appear as tabs in the link bar at die top of the page (see Figure 13). 
The Home tuition to ilie far left will always !\.^ium visitors to the 
Lop-level site. 


I irtffidwattt*! fwdwiieay 
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Figure 12. Site tabs in top link bar 

Making SharePoint easier to use 

Office for Mac and the DCC 

SharePoint is unaliasliedly a MkrosofL product and 
MicTostjfl makes integrating most of its servej- teclinologies with 
its w^ork.station tedinologies very easy. Office ftir Windows t:an 
seamlessly work witli SharePoinl and InterneL Explorer to give 
its users an unintemipted experience when editing documents. 
When clicked, a link to a Word document will download a copy 
of the document and Wor<l for Window.s w ill display its contents 
in seconds as if the user had opened the file from a local file 
server. Editing unci saving an Office document will quickly 
upload changes to the server without a blip. The same applies 
lo Excel and Pow'erPoinl I’iles. 

Macintosh users doift get such an integrated experience. 
Even with Safari's preference to Open '‘safe” files after 
downloading enabled, clicking a link will at ino.sL just download 
tile Microsoft Office dcxruinent to the user's Downloads folder. 
The Mac user must then locate the file and double-click it to 
view or edii. When finished editing, he must return to tlie 
SliarcPi)int site to upload the document, saving over the old one 
if necessary. 

At the Macworld Expo 2009 in January, the Macintosh 
Busines,s Unit (MacBU) at MitTosoft unveiled a new product 
called the Doaiment Collalx>ration Companion (DCC). 'the 
DCC promises to smooth out some of the wrinkles that Qffic:e 
for Macintexsh users face when dealing with SharePoint sites and 
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PARTS + UPGRADES + SERVICE 


INDIVIDUALS 

• Free Online Do-It-Yourself Guides 

• Send-ln Repair Service 

• Power Adapters from $24.95 

• Batteries from $94.95 

• Replacement Parts & Upgrades 

• Diagnostics 

• Hardware Installation 


(■ .-m. 




A SINGLE SOURCE SOLUTION PROVIDER 

FOR ALL YOUR TECHNICAL REQUIREMENTS 


DIALERS 

^^^Reselier Accounts 

• Outsource Repairs, 

Increase Profits 

• Blind Drop Shipments 

USE COUPON CODE MACTECH5 
TO RECEIVE 5% OFF YOUR FIRST ORDER! 



Powerbookiuiedic 



Your Mac Potient 



.com 


556 Sparkman Dr STE 1620 
Huntsville, AL 35816 
T 866.726.3342 
F 866.726.3342 


www.PowerbookMedic.com 










even goes so far as to enable working with OITicc Live 
Workspaces. Atreording to Microsoft's Mactopia website, tlie DCC 
is currently in private iK'ta and will be released taler in 2009. 

Putting the lid on the shoebox 

Little or nt^tlting has ixx'n said so far about advanced 
design, security, searching, personal pages, team discus,sions, 
project management, group calendaring or many of the odier 
features of Sharc‘Point. While individuals may never use half or 
even a quarter of its feature set, a small company c:an easily take 
advantage of many of the tools it provides. An enterf>rise can 
make ase of most, if not all, of its features. 

Half the battle of data management is filing content sti that 
information doesn't get lost or l^ecome difficult to find. As f)arL 
of a larger .set of collaboration toolS“Microsoft Office for 
documents, Excliange Server for E-mail and Office 
Communications Server for tiLstant messaging—SlmrePoini is 
poLsed to make sharing and orgiinizing information within a 
team environment or a company network quick and efficient. It 
really is a product that c'un sliine when individuals are allowed 
to play in a sandlx)x, so admirustrators should be encouraged to 
create sandlx>x sites ft>r their more creative power users. They 
will discover more when tliey are able to use as much of it as 
possible and be encouraged to continue using it. 

More information 

California Closets 

http://wvAW.oalifbrniados^ 


SharePinnt Server homepage 

hBp://office.mrcro 5 oft. 0 Dm/en- 

WsKarepantserw/defo^ 

SharePoint Designer 

ht^://'¥^.mkT05ok<xm/^ 

Office Live Workspace 

hllp; //v«)dcspcioe.oflkEl rve.com 

iGtx^gic 

hwp://vwsw. igoogb. ODm 
Windows live 

hl1p://home.live.com 
Itee SharePoint Templates 

http://technet.micriosoft,com/en‘ 

us/wirKJowsserver/stv 3 repoSnt/bfc 4 ^ 
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The Road to Code 


by Dave Dribin 



Chips or Fries? 

^Handling User Preferences j 


Favorite Word: [Cocoa ~~ ^ ^ 

Figure 2: General preferences 


But, let's not stop tliere. We should let die u,ser aistami:£e die 
Irjflckground color and text alignment, too, as shown in Figure 5: 


Introduction 

List niontli, we covered how to display windows and sheets 
using canned alerts via the NSAlert class as well as custom 
windows and sheets stored in separate nibs and displayed widi 
NSWindowControlIer sybckisses. Itiis iminth, we’re going to 
cover how to lumdle user preferences, as well as how to implement 
a preferences window tliat works like most Apple-supplied 
applications. 

Fni going to show you die end ic^uli, and then, well start 
tilling In the axle. Ttie application conutins a window widi a 
simple custom HSView subclass tku displays your favorite wml. 
as sliown in Figure't: 



Figure 1: Favorite Word window 



Figure 3: Advanced preferences 


As you am see, die pa^ferences window Is separated into tm) 
panes: the General pine and the Advanced pane. It is fairly 
lypit^al to setup multiple pines in preferences windows to separate 
ofitioas into groups. However, even tiiougli this is the standard 
practice for preferences windows, Apple does not provide us with 
a rc-ady-made preferences window. We ll have to write a fair 
anKxint of axle to emulate these standard windows, Bui don't 
wxiny; let me guide you down the rt>ad to axle. 

Main Window 

Let’s first go over the axle to setup the main window. 'Itie 
bulk of the cxxle Is in the aistom view' that dLsplays our favorite 
word. Create a fresh Gxoa Apiilicaiion project to work on (don’t 
forget to en^ible garlxige colleaion). Let's dive riglit in and aeate 
a new NSView svibclass callai WordView. Make the header for 
WordView match Listing t: 


We previtmsly oivered custom views, so there’s not a lot new; 
so far. Jlowever, Fd like to add in a pneferemes window so iliat 
the iLser cdn cfeinge tlieir favorite word, as shown in Figuie 2: 


Listing 1: WordView.h 

timport Cocoa/Cocoa.h > 
typetJef oitiia 

I 

WordViewLeftTextAligniiient, 
WordViewCenterTextAlignroonl. 
VordViewRightTextAlignment, 

] WordVicvTGXLAUgniiieiiE^ 
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Winterface VordView t MSView 
I 

NSStfing * _wordi 
NSColor “ _backgrouBdColor: 

WordVlewT&xiAlignment _teKtA 1 i gnirejit : 
t 

^property (copy) KSString * word: 

^Jproperty (copy) NSColor * batkgroundColor; 
^property WordViewTextAlignment textAllgnment: 


( 

NKHecl boimds faelf bounds]: 

NSRect pathRect = NSTnEctRc»ct(boLinds. 2 . 0 , 2 . 0 ); 
NSBezierPatii * path ^ 

[MSBezleirPaLh besiiorPalbWi LhRoundedKect: pathRnot 

xRadius: 20.0 
yRadJus 120 . 0 ): 

f baakgroimdCo 1 ot set): 

[path fill]; 


J>end 

'Ihis is \mAy self-explarmtory. We've ga three insr^mee 
variables artel [Ur'c. properties for ihe word, Irat kground color, and 
text alignment. Tlie meat is in tlie implementation, which is shown 
in Hill in Listing 2: 

listing 2: WordView.m 

^import "WordViev.h" 
e*inlprracc VIordView () 

(void} d rawBackgroiuid; 

- Cvoid)draWWord; 

fend 

static NSString ‘ RedrawContext #''Ee 4 raiiiContaxt’*: 
timplnmenration yordVlew 
tsynthealie word = word; 

<Ssyntbeside backgroundColor = 3 atdigrouijdGolor; 

<»flynthRsize textAllgTimont " textAlignment; 

- (IdllnifWtthFrame: (NSRficf.) frame 

I 

fielf = fstiper initVithFram^: frame]: 
if (self = nil) 
r<>Turn nil; 


Ipath setLineNidth: 4 , 0 ]; 
{[NSColor bUckColor] set]: 
[path stroke]: 


■ (voJdldrawWord 

I 

NSRori bounds “ [self bounds); 

bounds “ NSIusetRectCbounds, 4 , 0 , 4 . 0 ); 

, NSfont ' font = [NSFont syfitemfotitOfSizer^Oj; 

NSDictionary * attribiiten ■ 

[NSDir tionary dictionaryWithObject tfont 

forJtey ;NSFontAttributeNamel; 

NSAUrlbutcdSUlng * string “ 

[ {NSAttrlbutedString aiiocj InitWithString:_word 

attributes:attributes]: 

NSSize stfingSizt [string size); 

NSFoint point; 

// Center vertically 

point*y = bounds,size,helghl /2 strlngSize.heJght/ 2 ; 

// Align horlzonally 

if C text Alignment = IrfordVlewCenterTextAiignment) 

point.K = bounds.size. vddLh /2 stringSlze.width/ 3 ; 

elRp. if C texcAligniDenr •=^ WordViewLeftTextAlignment) 
point.X = bounds,origln.x; 

else If L text Alignment — Word Vi ewRight Text Alignment) 
point.X = bounds.size.width stringSize.width; 


_word ^ ^’'tford"; 

^backgtciundColor = LNSColor whiteColor]; 

,TRxtAl lgniTu?nT = WordViewCentfirTextAligmnent; 

Esolf nddObservor :se1 r forKeyPathi@''word" 

optiotistO context ;&RedravGontext): 

[self addObserverrseif forKeyParh;#'*backgronndColor’' 
options 10 context: HedrewContextJ; 

[self addObserver;sclf forKeyPath;#"textAlignmerit“ 
option s :0 c ontext:tRed rawCont ext J; 

return self: 

j 


1 

I 


{vold)observeValueForKeyPaLh;(NSString ‘)keyPalh 
ofObJ ect:(id)obj ect 

change:{NSUictioimry ')change 
context:(void *)context 

If (context = &RedtawContext) 

[seif setHeed sDispley:YHS); 


' (VO 1 d)drawRect:(HSRect)rent 
I 

Iself drawBackgtound]; 
Imlt dravWord); 

[ 


- (void)d rawBackg round 


[string drawAtPoint:point]; 

I 




liisidc die iniliali?£r, initWithFramsi, we setup initiaJ 
values for die woid, background color, and text alignment. Wc also 
.setup key-value observers Uiat monilor tliese tliiee prOfX'ities. If 
any t>r tliem change, we need to redraw' rite vie%^, which ts done 
liy calling setNeedsDisplay:. 'Ihe drawing itscHf happens 
inside drawRect; and is delegated Ui two mctliods 
drawBackground and drawWord. 

The drawBacItground meiliod uses a Bezier path to create 
a rectangle with rounded emners. Firsi, we 1111 Oie paili with the 
liackgrcHind aiov, and tliai we stroke it witli black to dnw tlie 
IxmJer 

lire drawWord method uses a das,s called 
NSAttributedString to draw djc woid witli a given font and 
size. An NSAttributedString Is similar to NSString except 
you C'an store attributes along with the string. Tliere are many 
pc\s,sible attributes, but we am only nsing the font attribute. Once 
we liave die attributed siring, we calculate foe cx>rrect position 
inside foe view and draw' it with the drawAtPoint: mclhfKJ. 
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Kemenilier the origin, pomi (0, U), is in die lowerdeft comet of die 
view. 

Now build die pmject, fix up any ^synt^ix emini, and open up 
die MainMenu.xib file in Inieiface Builder Set die tide of die 
window to Favorite Word, Next, drag a cajstoni view^ from die 
liljrary inttj die window, and set the cia.^s of the view to Word View. 
If you ran die application right now, it would ltx>k like Figure 4: 








^ > 

Word 






Figure 4: Initial word view 


Tliatls all we need tor t)iir ciLstom view, so it's time to start 
getting to the meal of the matter: u.ser prt'femnces. 

User Preferences 

• Cooxi has very good suptxjrt for user prefcienccs. The 
main class diat provides die interface to user prefen?aces is called 
NSUserDefaults. Every pmfearnce lias a name and a value, 
llie iKUiie niusi a string, and die value must Ix.^ one of die 
following classes: 

■ NSString 

• NSKumber (for integers, floating poinl numbers and IxKileans) 

• NSDate 

• NSData 

• NSArray or NS Diet ionary cif the alxive classes 

So let’s cover how to store tlie favorite worI in 
NSUserDe faults. For the preference name, lefs use 
FavoriteWord (ifs fairly customary to c:apiiali?:e the name), and 
the value will be whatever the user supjilics. Working widi 
NSUserDefaults is very similar to working with a mutable 
dictionary, and here’s how we'd set the iisei-^^s favorite word to Tie" 
In a real ai>plication, you wouldn't hard ctxle die value; tliis is for 
illustration purixises only: 

NSUserDefaults * defaults = [NSUserDefaults 
standardtJaerDefaultsl: 

[defaults setObject forKeyi^^FavoElteWord"!: 

That’s it! Tbe system take^ care of saving this to a file 
periodically, so diere’s nothing else we need to do. Note thal you 
use the +standardUserDefaults class nieduxl to get die 
NSUserDef aults instance, instead of creating a new instince of 
die class. This nietluxl always rettims die same object and 
represents die defaults for your application. 

Speitking of preferences tiles, where does die system store this 
file? Pmferenees for all applications aiitomabcally go into the 


directory -/Ubrary/Preferences, Eicii aptdicaiion has its own 
preference file named using its application identifier, Recall tfeit this 
identifier follows the reverse DNS convention and is set in the info 
panel of your application. Tlius, here is the full name of die 
preferences file for this application: 

-/Library/Preferences/org.dribin,dave.mactechjun09.Favortt 

e_Word.pliSt 

"Hie extension on this file, plist, stands for property list. 
Property lists are standard file types for holding configuration 
infomiaiion on Mac OS X. Tliercls even a separate appllaili(jn for 
viewing and editing profierty lists called Property list Editor. You 
can use diis application to verify that preferences are indeed being 
saved conealy, for example. Just lie aware rliat die preferences file 
only cxlsls t)nly after a user cliangcs a piiefcrencc. It W'on’l exist if 
die user only uses the standaid values, 

How do we reatl preferenc'ies using NSUserDefaults? 
Tliafs }u.sL as easy: 

NSString * favoriteWord = [defaults 
obj ectForKeyt @"FavoriteWord"]: 

LlTs pul this newfound knowledge into piacticc, Wc’r going 
to store the user's favorite w^ord as a string using the 
Favorite&?ord key, as we showed alxwe. For the text aligniiient, 
we'll store die inieger value of the WordViewTextAlignment 
eiiLini, wldch is short for emmrated type. Unlike a mutable 
dictionary, NSUserDefaults has .some convenience mediods for 
storing primitive numlx-rs so you don't have to wrap Uiem up in an 
NSNuniber yourself. Merc’s an example of liow we save die text 
aiignmeiit to die preference named TextAlignment: 

NSUserDefaults * defaults = iNSLfserBefaults 
standardUserDefaults]j 

WordViewTeKtAligumem aiignmant = 

Wo r d VI ewCejt t 5 t Al i [i[ii 0 [ 1 1; 

[defaults set Integer: alignment foi:Key:@“Tex±Aligtiment"] ; 

We can mad tlie value using die integerValueForKey: 
method. 

Storing a color Ls a bit tricky, You ll notice that NSColor is not 
one of the sufiporled value daxses. Fonunaiely tlie NSData type 
can often lie used as a catchall to handle non-standard values such 
as tx)lors. 

ReiiieiiilxT that archiving allows you to turn any class that 
implements die NSCoding protocol into a stream of bytes stored 
in NSData, 'Ilie NSColor class implements NSCcding so we just 
need to eonven the color into an NSData before we store it in die 
user preferences, and dien conveit die NSData Ixick into a color 
when reading out of die preferences. Herds how' we'd store a red 
eok)r with the BackgroundColor name using an 
NSKeyedArchiver to convert an NSColor into NSData: 

NSUserDefaults * defaults “ [NSUserDefaults 
standardUserDefaults]: 

NSColor * color -■ [NSColor redColorl ; 

NSData * colorData " 

[NSKeyedArchiver archivedDataWithRootObject:colorJ; 

[defaults setObject:f;olorData forKey:@'*BackgrDundColpr''l; 
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regardless of location. 
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ticated enterprise server to continuously protect your 
business onsite, offsite, and online. 


People Friendly. Enterprise Tough. 
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Continuous Backup for Business. 





That’s definitely a bit minv cumlx:nv<}me than storing a string, 
as above, but it's not too bad. Conversely, turning the data Irack 
into a color recjuiies using NSKeyedUnarchiver^ 

NSD&tfl " colorData • [defaults 
objectForSCey: t'^BackgroimdColor"]: 

NSCotor • colar * 

iHSKeyadlFnafchiver unarcMvdDbjectWI thUntaicoloraata]; 

Let's integrate this into our application. Create a new 
NS WindowCont roller subclass called 

MainWindowController, Add an outlet to a WordView 
instance, as shown in listing 3* 

listing 3: MainWmdowController.h 

^import <Cocoa/Cocoa.h> 

fe?lasi3 Word View; 

tintorfBCD MainWindowCoiitroller : NSWindowControiler 
I 

WordView * ^wordView; 

I 

tproporty (nenatoralc, retain) TlOutlci WordView * wordView; 
tend 

Hk* coTOsponcling implementation file is shown in Listing 4: 

listing 4: MainV(lnfiowControUer.m 

#iiiiport ^llainWlndc>wController*h" 
import "WordView.ti” 


NSString * FavoriteWordKey “ @"FavoriteWord''; 

NSString * Background Col orKey = Background Co lor**; 
NSString * TextAligmentKey = ^'ToxtAllgnmont**; 

iinterface HaicWindowContrcillei {) 

- (void)updateFrotiiDefaultfl; (RSNoUflcatloa ' Jnpliflcatioti; 


wordYiew^backgroundGolor * color; 

WordVlewTextAligiun^snE alignment “ 

IdefaultE integerForKey iTextAligneiitKey] i 
.wordVlew.textAligmivent " aligruaent; 


Send 

The awakeFromNib method first updates our wofd view* 
widi tile values stoird in the pTeferences, But it also subscribes to 
NSUserDefaultsDidChangeNotification. Tliis alkws us 
to keep up-to-date if the preterences change after the appliaition 
bundles and will lx,‘ important once we implement the preterences 
window. 

The updateFromDefaultsJ method uses suing amstants 
instead of siring literals. This helps reduce simple typo errors when 
using tlie same string over atid oivlt. The compiler will not let you 
use a mistyped constant, whereas a niistyj:)ed string literal can oiiise 
hard to find bugs. 

If we ran tlie application rigfit now; wed mn into a bit of a 
problem. The first time die user mas die apf^lication, tlieir 
preferencx-s are empty, and so we'm nix going to get any useful 
values out of tiiem. Wlmt w'ed like to tb Ls setup some sensible 
defaults diat die u.sct can later uverride. We cm dt> ihLs by adding 
one more method to our implementation: 

+ (void)initialize 
( 

NSMutableDictionary * defaultValues * 
fNSKutablelllcllomify dictJonitry]; 

IdefauitValues setObject:S“Cocna" forKeyiFavoriteWordKey]: 

NSCclor ‘ color - [fJSCoior redColor]; 

NSDaia * colo^D^)ta “ 

iNSKeyedArchivsr archiv^dDataWlthRontObjecticolor]: 

[defan11Values secObject;colorUata 
forKaytBackgroundCDlorRey]; 


tend 


giaplettientailon HalnWindowController 

isynthesize wordVlew “ _wordView; 

- Cvold)awakeFroaiNlb 
I 

[fieif updateFromDefaultsiBil]; 

KSNotjficationCeoter ' defaultCenter = 
[NSNotificatiorjCenter defauitCenterl; 
fdefaultCenter addObservertaeli 

selector: #b «1 r c t or (upd a t eFc gitiDe Ta ul t s:) 


name; fiSUserDefaultsUldChangeNotlf icatlon 
object:ail]: 




- (void)updateFroiiillefaults: (RStiorificatioa • Jnot lflcaiibn 

I 

NSUserDfiLfaultfl * defaults = [NSUsetDefaults 
standardUserDefaults]t 

_wordVlai#.wocd * fdefanlts objectForKey:FavoriteWordKeyJ: 

MSDats ‘ colorData ^ [defaults 
objectForKey: BackgrouftdColorKeyJ: 

NSColor • cdlor " 

[NSKeyedUnarchiver urvarchiveGbJectWithDataicolorData]; 


NSSniaber * allgnMentNttmber 

[NSNunber nmnberVithInt’WordVievCentecTextAligraiieiitJ; 
[defaultValues setObjeet:allgnmeatNumber 
forKeytTextAllpaentMey): 

NSUserDefaults * defaults - ISSUserDefaults 
staadardUserDefaultsl: 

Idefaults regiBterDefaultsidefaultValuesJ: 


Tlie iinitializc meihtxl is a class metliod, not an instance 
method. It Ls also special in lliat it gets uilled auiomatiailly lx:ft>re 
the c!as.s is ever instantiated. e%^en IxToix* awaXeFromWib. Were 
using this a.s an opportunity to register sensible defaults with 
NSUserDefaults Ixfone awakeFroirtJib cvct gets called 

Note that the ragisterDefaults; method takes a 
dittionary. Thus, we have to convert the alignment enum into an 
NSNumber, first, Otlier than tJial, we've setup the default favorite 
word to be ‘'Cocoa* the lyackground to lie md, and liavc cxtitered 
alignment, tf we ran the application riglii now (don't forget to 
lKx)kuf) dx: wordView oulkt), it will look jiLst like Figtue 1 alxive. 
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If you have a smartphone, 
we can sync it. 



The Missing Sync product family connects the coolest devices 
with Mac OS X. Reliably synchronize your address book, calendar, notes, 
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Smartphone faalur&s vary tmm model lo modelt so eynol^ortoition features and capabilities wm vary from product to product. 
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Preferences Window 

Ntjw that we've ggt oiir view ;ill seatp and tracking user 
dcfuiilLs, we need io have a way tor die user to attually edit them. 
On the one hand, diis is fairly easy witli Oxxja irindings. On die 
other hand, creating a preferences window that works like a 
standard prefcTunce window Ls not triviaJ. 

Start off by creating a ne%v Window XIB file fn>m Xaxie and 
call it Preferences^xib. llien, aeate a new^ corresponding window 
a)nin)ller named PreferencesWindcwController* Override 
tile initializer to use die preferences window nib: 

' (id)init 
[ 

Belf =* fjsupijr InitWlthWlndowNibName:^'*Preferences'']: 
return eeifi 

1 

Back in our main window tontrolier add this action methcxl: 

- (TBAc'tlonJflhotfPreferencesWindewr (idj sender 
i 

if f^preferencesWitidcuiContrtiller =“ MI) 

I 

_pirefereficesWlndowCont roller = 

I [PreferencesWindoMCoatroller all cm:) Inlt]: 

I 

IjpreferencesWindowControiiei shoWindowiselfJ i 

1 

You'll also need to add the corresponding instance variable to 
die [leader ThLs action method uses die prefcamces window 
ainiroller to load and display a preferenc'es winciow. 1be menu 
thit you want to connea this to is named Preferences. untler the 
appliaition's menu, as shown in Figure 1. 


Favorite Word 


Main Menu 


_ File Edit Format 

About Favorite Word 


Preferences... 

9«. 

Services 

► 

Hide Favorite Word 

m 

Hide Others 

^:sgH 

Show All 


Quit Favorite Word 

96Q 


View 




Figure 5: Preferences menu 


m O 

Window Attrfbuttl 




^ O 

4> 


^ Wimioiiy 


TTUe Window 


Aiiio&ave 

Cohfrt>Ls ^ Cld&ti Resize 

O Minimize 

Appearance H Teirturcd ^ Shadow 
Q Display Tooltips 

0 Unified Title And Tpoibaf 
Q Show? TooltNir Button 
Behavior Q fteJease When Clased 
O Hide Of! £}eactivate 
Q Visible At Launch 
Q Auto Recalculates View Loop 
Mcmoiy Deferred O One Shot 

{ttuffered f?! 

Figure 6: Preferences window attributes 

Wu now liavc enough in place* thai you cun lust tiie 
preferences window. It currently doesn't do anything useful, but 
you am make sure the PrBferences.*. menu Is hooked up properly 
and displays the preferencc.s window from tiju aiti file. 

llie first step in creating a standiird pruterences window is to 
add a toolbir to tills window. 'Icxjlhars are tyi>iailly used to add 
slioricTiis lo a)mmonly lustxl aciinas, but they are also what give 
[iielerences windows tlieir distinctive kx)k. 

r)nig a toolbar out from the Library and onto your prefenenexs 
w'indow. Ii a>nies pmctmfigural with some .standard toolbar items, 
and wliile iJiese may lx: uscfiil For a iradilional Kjollrar, we don't 
want any of tlieni for txir prefeRmccs window. Doufile click on tlie 
f<x)Ilxir and a aLstomize sheet appairs, as in l^ure 7* 


A 

Coton ftr^ 


WllTCtai# 



Allowed TooilbAf fum* 

ColBri ronti SepatiJur rltjtltf a Sfuce Cuiraumi# 


r Odna 


T 



We are going lo w^int to customize many of the window ____ 

atirilHitc*s of the preferences windows Make sure they all match 

those in Figure 6, Rg^re 7: Default toolbar 


Drag each and every toolixir item off the Allowed Toolbar 
Items section to get an empty t(X)ifrar. Replace them with two 
Image Toolbar Items I'nan die Library. Configure die first one on 
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the pain of font 
management 


ESG> frequent font server crashes 




font licensing headaches 


ESC> limited font selection for creatives 




unintuitive font management administration 




the tech support runaround 
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multiple contacts for font management font purchases, 
font license management and other font needs 






E3C> the pain ovfont msnegen'isjit wn:h trxe X Seii/er solutfcr! 


FontExplorer X; font management from the font experts 

Linotype and Monotype Imaging have learned to bring you 
FontExplorer X Server This unmatched font 
managennem solution combines a robust feature set that 
the creative workflow demands, a solid architecture 
and an intuitive nature that network administrators need, 
and a selection of world class fonts that creatives crave. 
With powerful font management capabilities and 
licensing for our renowned Linotype? Monotype* and 

fc-tYpE 

Linotype GmbH 
Wemor-Reifners-StTBae 2-4 
613S2 Bad HamburQ 
Germsny 

Phone; i49 f0| 6172 4fi4 418 


ITC* OpenType* font libraries, FontExplorer X Server 
provides an unprecedented solution for managing fonts 
across creative organizations or large design groups. 

See how your organization can benefit from centralized 
font management — and the convenience of having 
a single contact for font management, font licensing, font 
license management and any other typographic request. 
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the left to have the attriliuies in Figure 8. Set the Image Name to 
NSPreferencesGeneral. both the Label and Pal. Label to General, 
and the Tag to 0. 
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I ^ ^ 1 0 i 

T Toolbar Ittm ?? 



Image Name jKSPrefcrenccsCeneral 

Label 

■ General - 

Pal Label 

1 General 

Tag 
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Priority 
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Figure 8: General toolbar item 


Ctinftgnre the setxtnd uxtlltar item suniktrly, setting die Image 
Name to NSAdvanced. the Label and Pal. Label to Advanced and 
the Tag to 1, as show in Figure 9. 
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▼ Toe^l bittern 
Image htame ( NSAdv anced 
Label 
PaL L^bef 
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figure 9: Advanced toolbar item 


button. Edit tlie atlrilxites of tlie toolbctr itself to match Figure 11, 
which should just be unchecking tlie Customizable checkbox. 

■*! ! 0 ^ ^ I eP ■ O i 

Display Icof* Label 

r Regt^r ^ 

Q Autosaves Configuratrori 
0 Visible ax Uunch 
Q Customizable 
Separator 


Figure T1; Toolbar attributes 


One last thing before jumping frack to XctJcJc, set tlie class of 
RIe's Owner to be the PraferencesWndowCont^ and set the 
ddejjpiic of ilic UK)ll>ar to Ix^ Rle's Owner. Also, I want to pt)im 
out dial editing toolbars and toollxir items is new to Interface 
Builder in Mac OS X 10.5 In previoas versions of Mac OS X, you 
had to create the i.cx>llrar and Ux>llw items aU in code. 

Back in Xcode, add diis toolliar deleg^ite methcxl: 

{NSArray *)toolbarSelectablelteinldeniifiers:(NSToolbar 
*)toolbar 

I 

MSWuubleArray * Identifiers - [NSHutableArray artsy] ; 
for (NSToolbarltera * item iii L tool bar lietnal) 

I 

[Identifiers addObJectr [item Itemldetitifler]] ^ 

I 

return Idcnttflerej 

I 


Niimialiy ttxilbar items work like push buttons: they are only 
higliliglited when tlie mouse is down. St^lectable toullrar items stay 
liighlighted itfter the nxKise Ls clicked and are dniwn mi\ a special 
highlight. Our method iclLs the tcxJlmr iliiit all items are seleaable. 


Orag c'iicli toolbar item from the Allowed Toolbar Items 
section onto the actual toolbar, and your window should lcx>k like 
Hgure 10. 

AllDWfld TDollMr Items 

a 

CcfWfid Aitvan<«d 

0 PO TM 

Figure 10: Preferences tCKilbar 

We*re done editing the kx^lbar for now (we'll liave to axne 
Irack and amnea aaions to die items ktter), so click on the Done 


View Controllers 

Before we finish olT tlie rest of die ctxle for die preferences 
window ocjnmdler, let's talk alxxit wbit we're going to aceomplish. 
Ofxn die prefemnees for a stanckird Apple application, such as 
Mail iQd, or Address Book. You 11 notice diat when you click on 
a toolbar item, die contenLs of the window are briefly lilanked until 
die window lesrzes and the oDUtents of' the windtiw are rqilaa^d 
with new a)ntrols. If you watch closely, you'll notice that die 
window only resizes vertically. Tlie widdi stays die same, no matter 
whieh preference pane Ls seleaed. What's happening is a 
teclinique called uiew suxippiftg. 

We're going to put our General preference pane and 
Advanced pa-TercTice fxine into their own views. Thtm, when die 
UxillxiT is clicked, we're going to ,swjp iiul die current view and 
swap in die appropriate view. As anotlier Ixmus, we’re going to 
store these views in their own nib. Just like keeping window.s in 
dieir own nib, storing views in their own nib reduces ineniory 
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a)nsunipii(m f)y only krjclin^ the vi^s aj; tliey are needed. If the 
user neva* clicks on tllc Advanced prefL-rL-ncc pane, rl in nt:ver 
Imded into memory. 

Just as we use a window contmller to kxid a window from a 
nib file, there Is a class new to Mac OS 10.5 oiled a uietr 
that loads a view fcni a nil:) file. Let’s create our view and view 
a)ntn)ller for our General preferences pane. 

In XccxJc, create a new class^ name it 
GeneralPreferencesController, and diange tlie super class 
to NSViewControllar, as shcmTi in Listing 5. 

Listing 5: GenefalPrrferencesControUer,^ 

Hmpott < Cocoa / Coc oa. b > 

@interface GoneratPrerert^nceaController : WSViewControllef 
I 

J 

§end 


The implementation cla.ss Is short, as shown in listing 6. 

Listing 6: GeneralPreletiencesContraller.nt 

iinport “GeneraIPreferencesController.h" 
timplaaeniat ton CeneralPreferencesCoTitroller 
(Idjinlt 

( 

seif ^ itiitVithi'!lbNaiiie:tf“GeneralPrGfeiencBS'^ 

bundleiuill: 
rciTurn 

) 


ieod 

All ii does is loatl the a>rrea nib ftle. You could aigue diiit a 
se|xirate sulx:tas.s is not wtxiJiwliile in this case, and rliafs prohihly 
true. Bui leal preference jxuk^s will most likely neexl exim cixie 
behind them for actions and cmdefs, so you’d need to create a 
subclass at tltat point. We’m lucky enough to be able to use Oxxxi 
bindings, but I think it’s a gtxxl idea to oeate llie subt:lass up front 
so you have a plat^ Co put code when you need it. 

Nt)w aeatc the coirttsponding nib file by cteating a new View 
XIB file, as shown in Figure 12. Name this nib file 
GeneralPreferences.xib, and open it up in Intei face Builder. 


our n«w ftle; 


Mbclati 


ir" 


HSW^ndMConttt! 


tr- 



OncrCptlon An Meftan iuiLdcttfocvmefM for crHtir>g a Ckn 

To cmlofwin OHf Oocumenc. efrag controi:* fwi l^e 
Ubmfv onto the vi«Hir ini vm iM iiupKtv i? m 
. CWfjgtf rg a )Am w 

euitort control cHah wWt outl«i KOont 
connemd to V«yr VHm to CvKOnUi^ 


Figure 12: New View XIB file 


Tlie first tiling yoifl] want u> do is set tlie RIe's Owner tJass to 
GeneralF^ferencesController. Next, ytxill want to add a laliel 
and a text field to the view. Note that in Interface Builder, our view 
kxjks an awful lot like a window. But keep in mind tliai, despite 
its looks, ifs a Ixtre view without an enclosing window. The Gnal 
lay<)Ui should kxik like Figtine 13- 


i* ^ 0 Custom View 

_ 


Favorite Word: 

1 ! 

J 


Figure 13: General preferences view 


Using Gkxxi bindings, we on keep tliLs text field in ,s 7 nc with 
NSUserDefaolts witJioui writing any cxxle. Open up the 
Bindings section of tlie Inspector jxmel for tlic text field, and l>ind 
to Shared User Defaults Controller, setting ttie Controller Key to 
values and the Model Key Path to FavoriteWord (with no space) 
as shown in Figiim 14, 



▼ Vitue tSIiired listr Oef .,r«vjitues.Fiv<KitftWord) 
Bind to: [ Shar&d Listsr DsfatjHs Con.., ij||| 
Controller Key 


I values 

Model Key Path 


B 


: FavoriteWord 
Value Transformer 


B 


3 


M Allows Editing Multi p*ic Values SetecUors 

Figure 14: Word view bindings 


The Shared User Defaults Controller Is a speckil, built-in 
object controller iliat cunnecLs dmxdy to tlic sliarcd 
NSUserDefaults, Ihe model key paili is the name of the 
prefcTcnce you want to bind to, .so this must he the same string we 
used in tlie main window controllcT. And through the magic of 
bindings, weVe succ'essfully allowed the user to edit tlieir favorite 
word. 

We now iiavc to go through simitar steps for ihe Advanced 
preference pane. Create a new^ view controller sulxlass, !>ul tliis 
lime name it AdvancedPreferencesController. Override 
the initializer and load the nib file named 
AdvancedPreferences. Finally, create a nc*w View X!B fJe 
named AdvancedPreferences.xib and open this in Interface 
Builder. 

Again, die first step is to diange die RIe's Owner class lo lx* 
AdvancedPreferencesControllar. Layout the \iew to match 
Figure 15 by dragging iwo laliels, a color well, and a radio button 


MACnCM 


The Road to Code; Chips or Fries? 






















group from the Library onto the view. By default, a radio group 
only iia.s two huttoas. To aeate die tiiiid l^uttoti, drag down as if 
you were resizing the view, Ixtt hold down the Option key. 


I ^ Hiifi 


Background Color: 


Text Alignment: 

©Left 
O Center 
ORS^ht 


Tigure 15: Advanced preferences view 


Ag^iin, we can ctinneti the ctilor well and radio liution gaxip 
using Coaxi l>indinj?i. For die color well, bind die Value lo the 
Shared User Defaults Controller, but this time use 
BackgroundColor as the Model Key Path. We also have to deal 
with the fact that the a)lor Is stored in tlie preferences as NSData. 
Change the Value Transformer to lie 
NSKeyedUnarchiveFromData. Value transformers m as a 
middlenruin Ixtrween the view and die controller. Theiu are various 
Ixrih-in iratisfomicrs, and you am cTeaie your own, but we can use 
the one that archives and unarchives the v:due. 'ITie bindings 
options should match Figure 16. 


For the radio button group, you are going to bind the 
Selection Indexes to Shared User Defaults controller. Set the 
Model Key Path to TextAiignment. I'here's no need to change 
anytliing else, as it will automatically convert lu and from an 
NSNumber instance. 

Make sure lx>t!i view nibs are saved, and it's time to head 
liack into Xcode to code up the view swapping. Update the 
header file for PreferencesWindowController to match 
Listing 7. WuVc added two instance variables, one for each 
view controller, and an action method that the toolbar items 
will use. 

Listing 7: PreferencesWindowContraller*h 

Jlniport <Cocoa 

Gsnera.lPrefereoce&Conttoller; 
gdass Advancedl^refereticeiiCoTit roller I 


tlnierface PreferenceBtfindovController : NSVindowController 

t 

GeneralProfereticeisCofitroller * ^generalPriferetiCes; 
AdvancedProferencesCor^ttoiler * ^advahcedPrefereuces; 

1 


- (IBActionlctiangGPreferencePane; (Id)Gender; 
#end 


In the implementation file, add the accessors for the view 
controllers: 


ilia. 




4k ^ 


^ I 1^ 0 0 


Vilue 


V Value (Shared User Def lue$.BackgrdundCoiorl 
M Bind to: f shafcd User DefauHi Con... 
Controller Key 




Model Key Path 
[^ckgroiindCoior 


TD 


Value Transformer _ 

NSKcycdUnarchiver romData ^ 

Allows Editing Multiple Va!uts Selection 
Q Always Presents Application Modal Alerts 
^ Conditionally Sots Enabled 
O Conditionally Sets Hidden 
M Raises For Not Applicable Keys 
□ Validates Immediately 


Availalwlity 

k Enabled 
^ Hidden 
Parameters 

► Tool Tip 


F^re 16: Color well bindings 


♦ (GoneralPreferenceflCuntrtil l t!t * )&enDral Preferences 
( 

if (^leneralPreferent “nil) 

I 

.generaIPreferencea - 

[tGeneralPieferenceaConTroller alloc] Inlt]; 

1 

return . 4 eneia 1 Preferences; 

1 

- (AdvaiicedPreferencesControllef MadvancedPreferences 

I 

if LadvsneedFreferenees “nil) 
i 

.advancedPreferencea - 

[lAdvaricedPrefer^jnc^sControllet alloc] initj; 

I 

return _©dvancedPr ef prc?ni:«s ; 

1 

Thc.se create the objects as needed Again, ihis keeps 
memory consumption clown by only creating objects when 
they are needed. Next, add tliese three methods that 
im[)lemeni the view swapping: 

- (IBActionlcban^ePreferencePane;(id)sender 

I 

[self selectPrefecencesForltein^fiender animate:VKS] ; 

* (void)selectPreferencesForltera:{KSTnnlbarIteB 'litem 

animate;(BOOL)animate 

( 

NSTnteger tag = (Item tag); 

NSViewCootroller ‘ preferencesConlroller = nil: 
if {Ug PreferencesGeneralTag) 

preferencesController “ [self generaiPreferences]: 
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else if (tag = FtefereticesAdvancedTag) 
preferencejsCont rol ler = [self 
advattcadpreferences]: 

Iself EelectPrefetences:prefetenceaCoatroller 
aalnoBte ^aniiiala] : 

ILeelf window] setlitle:jltem label]]: 

1 


view Iwi'fore resizing the window and add in the new view 
when it's finished. We also ensure the new view's width is 
resized to the width of the window. 

That’s the built of iL. We need to make sure to connect 
up the toolbar items to liie changePreferencePane: 
action and add in two more methods for some final touches: 


(void)selectPreferetices: (KSViewControHer ‘ Jptefer^nces 
aniiaatej CBOOL)anifflate 


NSView ’ ttontentView = [ [e^If window] contentViewl; 
WSView * preferencesView ” [preferences view]; 


a Calculate the change in height 
fJSSize currentSi?.e “ [contentView framej^elze: 
NSSlze nevSi^e * [preferencesView frame].elze: 
CGFloat del tailed, ght " newSize. height 
currentSize*helght: 


U Calculate the window's new frame 
KSWlndow * window = [self window]t 
NSHect windowFrame = [window frame]: 
wifidowFrame.slste* height += deltaHeight; 
windowFrame*orlgin,y' delt^Height: 

// Remove the current view 
for (NSView * view in [contentView subviews]) 
[view removeFromSuperview]; 

if Resize the window 

[window setFrame:vindowFrame display:YES 
animateranlmete]; 


// Resize the new view*s width 
newSize^width - currentSlze.width; 
[preferencesView setFrameSLae;newSize); 

// Add it to the window 

[contentView addSubvievipreterencesVlew]; 


- (veld)showUindow:(id)sender 

i 

HSWindow • window * [self window]; 
if (1[window IsVisible]] 

[window center]: 

[super showtfindew:sender]: 


(void)wlndowDldLoad 

[ 

NSToolbar * toolbar = [[self window] toolbar]; 
NSToolbarltem * firstItam “ [jtoolbar items] 
objectAtIndex:0] ; 

[toolbar setSelectedltemldentlfier;[flrstltera 
itemldentifier] ]; 

[self eelectPreferencesForltem:flrstltem animate:N01; 

} 


Tlie first metlKxi overrides die default implementation of 
showWindow: to center tile window on screen before 
displaying it. This is not strictly necessary, but 1 find it looks 
nicer. Tlie windowDidLoad method is necessary to ensure 
dial the General preferences view is initially swapped in. 
Notice that we're using the same methrxl the Kxjlbar action 
method uses, but we Ye setting animate to NO, as we want 
the window to display immediately without any animation* 

Conclusion 


IxTs work our way through these rnelhtxLs from I he top 
down. The first metlKxl is our action methtxl that gels called 
when either of the toolbar items is clicked* Tfte sender of the 
action will be the tmlbar item that the user clicked* Tliis 
simply calls into the selectPreferencesForltem: 
method with the animate argument set to YES. 

The si^concl method uses the tag of the toolbar item to 
select the correct view conirollcT. We use an enurn to map the 
tag values into compile time constants, Tliis ultimately calls 
through to the third method, 

selectPreferences: animate:, which dtics the actual 
view swapping. After the view swapping is finished, it sets the 
title of the window to be the same as the toolbar item label* 

The algorithm for view swapping ts fairly simple: remove 
the existing view, resize the window with or without 
animation, and add in the new view. Tlie only tricky part is 
knowing how much to resize the window. We compute the 
difference in height between the current view and ihe view 
we are swapping lo, and change the IVaine of the window' by 
that same amount* Remember, the origin is in the lower-left* 
again, so we need to adjust the origin so that the top of the 
window does not move. Tltc 

setFrame: displays animate I method does the fancy 
animation For us* All we need to do is remove the current 


Tills has probalily been the longest example we've done 
so far. if you don't want to type in all this code, feel free to 
download the completed project from the MacTech website* 
Congrats for keeping up* More gtxxlies to come next month 
in The /^om/ /o Code. 
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br Administrators, Part One 


When, where, why, and how you should run 
administrative scripts 


By Greg Neagle, MacEnterprise.org 



MacEnterprise.org 

Mac OS X enterprise deployment project 


Introduction 

In ]:)revious MacTech coiunin^s, 1 liave sonietinie^j offered 
up a script or two as part of a solution to a particular problem. 
Even if the script I presented is a perfect fit for ycnir 
environment, you might still have had tr(>ul>le making 
effective use of it in your organization, l>ecause you did not 
know how to make it run at the right time or in the correct 
context uj get the job done. 

'I'iiis month, well begin a lot^k at some of the many 
mechanisms available to run scripts (and other processes). 
Each mechanism has different uses and is suited for a unique 
set of Uisles. i^epending on wliat you need Lo accomplisli, you 
should select the appropriate mechanism. 

Why? 

The first question you should ask is ""Why do 1 want to 
run this script? What task do I want to accomplish?'^ Some of 
the common administrative categories that might lend 
themselves to scripting are; 

System configuration - iniiial setup of the OS, 
networking, user accounts, etc. 

System management - ongoing management of system 
settings; enforcing sy.stem-wide policie.s 

User seLlings/preferenccs configuring applications; 
setting up useful default preferences, enforcing user-level 
policies 

Administrator tools - tools to make tedious or difficult 
tasks easier or more consistent 

] iaeks/fixes/workarounds - scripts to “fix' or work 
around problems with the OS or applications (or usersO 


When? 

Once you know why you are running the script, or what 
you want to accomplish with the script, you can consider 
when it should run. Some of the possibilities: 

On demand - only wiien invoked by an admin or user 

At siariup 

Repeating (daily/weekly/monthly, or other intervals like 
hourly, every 15 minutes, etc) 

When a user Itjgs in 

When a user logs out 

Lei's look at some logical pairings of''Why?” and When?”: 

Utility scripts or administralive tools dial are to be run 
only on demand are the easiest to handle. Simply put them in 
a directory somewhere and run them manually as needed, or 
run them remotely using Apple Remote Desktop or SSll. 

If your script is doing system configuration tasks like 
binding a machine to Active Directory c^r creating local users, 
it should almost certainly run at startup. System management 
tasks might run at startup, on a repeating schedule, or ix>th, 

'I'asks that affect user settings or preferences should 
probably nin at user login, or if it's a cleanup task, perhaps at 
user logout. 

llacks/fLxes/workarounds can vary when it is appropriate 
to am them: they may need to run on demand; they may need 
to run at login to make a change to a user’s environment; they 
may need to run at startup to clear out stale cached data. 

How? 

How can you run your script when you want? let’s look 
at some of the available mechani^sms. 
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Running a script at startup 

Tliere aa^ .several ways to run scripts at startup, but the 
5 VO most commonly used on Mac OS X are StaiTupItems and 
launchd items. Roth Startup Items and launchd's 
Launch Daemons run in the rkjI contexL 

Startup Items 

Startup items have been used on Mac OS X for a lung 
lime, and continue to work in OS X 10.5 Leopard, 
Administrator-provided Startup items should be placed in 
/Library/Startuplterns. Since Apple is phasing out 
SuirUipUems, we won’t spend a lot of time on tliese. A Stiirtup 
Item consists of a directory containing an executable 
(typically a shell script) and a StarttipParameters*plist 
file. Both the execuiable/shcll script and the 
StartupParameters. plist have a very specific format, 
'Lhe startup item directory may optionally contain other items 
- for example, a Resources subdirectory. Apple lus some 
good documentation on creating Staitupltems here: 

http://developer.applexom/clocument0tion/MocOSX/Co 
nceptuo I/BPSystem Startup/Articles/Startupltems. html 

launchd items 

launchd was introduced with Mac OS X 10.4 Tiger, It 
was intended to replace almost every otlier way of launching 
prtx'esses, though in practice it lias not yet accomplished that. 
Still, launchd is very capable, and Apple continues to 
enhance iL Launchd (Urns are simpler u> setup than 
Startupltems, as they generally require only a single additional 
file other than the actual script or executable. Administrator- 
provided launchd items that nin a script at startup sliould go 
in /Library/LaunciiDaemons. 

Launchd has l>een covered extensively In MacTech as 
well as many other places, so I won't go Into great depth. But 
let's do a quick example. Let's say we have a configuration 
script that we want to run at startup, it is located at 
/Library/Management/configuration.sh, and is 
marked as executable. It looks like iliis: 

#I/bin/sh 

logger -t configuration "Hello from the config script!" 


This script simply writes a messsage to tlie system log. You 
cm test it manually: 

root# /Library/Management/cottfiguration.sb 

root# tall /var/log/systGia^log 

<S[iip> 

Ape 21 12i31t05 arcus configuratidnl8400] t Hello frrun tbf» 
config script! 


To get it to run at startup, you'd need a property list at 
/Library/LaunchDaemons/com,mactech,demo.plis 
t that looks something like this: 

<?xml version”" 1*0“ enc&ding“'’UTF-8“?> 

<ID0CTYPE pllBi PUBLIC “ //Apple Computer//DTU Pl.TST 
1.0//EN" "http ://www.apple.com/ETDs / PropertyList'1,0 .did "> 
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<plist v@rsion="l.0"> 

<dict> 

<key>Label</key> 

<Striii^>coiii. mactecb, /string) 

<key>Pro|raniArgwraertta</key> 

<array> 

(string)/Library/Management/configuration►£!!</string) 
(/array) 

<key>RunAtLoad</key> 

(true/) 

<key>OnDeiDand ( /key > 

(true/) 

(/diet) 

This property list should have owner: root, group: wheel, 
and mode: 0644, Some explanation of the included keys: 

Label is a string used by launchd to identify the job. 
'ilie name of the plist file is usually the same as this label plus 
“.plist”* 

ProgramArguments is simply the full path to the 
executable script, 

RunAtLoad is set to true so that launchd will run the 
job when it loads it, which Ls normally at startup. 

OnDemand is .set to true so tlvat launchd won’t attempt 
to restart the script once it exits - in other words, this 
prt3ce.s.s/script is not meant to run continuously. 

We could test the launchd job by rebooting and then 
looking at the system log for our message, but rebooting can 
take a while, and if there’s a problem, the fix/retest cycle is 
tedious. So let’s do a quicker test: 

toot# launchctl load 

/Library/LauuchDaetnonfl/coin, inactech. d^mo. pi lat 

toot# tail /vat/log/system.log 

(snip) 

Apr 21 12:31 1 05 arcus configuration[8400]: Hallo from the 
coufig script! 

Apr 21 12:37:13 arcus configurationl9073]: Hallo from tha 
coufig script! 

At the end of the system log, you should see the message 
from the configuration .script. 

If you have problems, unload the job: 

root# laiirchctl unload 

/Library/LaunchDaemons/com.mactech.demo.pliat 

Make your changes to the plist, and try loading the job 
again. Once the job is working, you should be able to reboot, 
and see the me.ssage in the .system log during the siarrup 
process. 

Apple documentation on creating a launchd item is 
availa[)le here: 

hifp://deve!openapp(e.com/ documentation/ MacOSX/Co 
nee ptua I / BPSys tern Sta rtup/A rt i cles/Lou nc ho n Dema nd Daemo n 
s.html 


Repeating scripts 

Some scripts are liest run on repeating intervals. For 
example, you liave a script tliat scans die startup disk for all 
installed fonts and then uploads that list of fonts to a database 
somewiiere so you can monitor for license compliance. You 
should run that script periodically: maybe daily, maybe 
weekly, maybe monthly^—it’s up to your organi5:ation. *rhere 
are .several ways to do this. 

One of the easiest ways is to piggy-fiack off an existing 
facility for running repeating scripts: the periodic 
command. By default, periodic is used to mo scripts on a 
daily, weekly or monthly basks. It runs all tire scripts it finds in 
certain directories: 

/etc/periodic/daily/ - these are run every day 
/etc/periodic/weekly/ - these are run once a 
week 

/etc/periodic/monthly/ - these are run once a 
month 

To get periodic: to mn your scripts, mark them a.s 
executable and put diem in the aj>propriate directory. You 
oin control the order in which the scripts run by naming them 
appropriately. The convention used is to start the script name 
with a tltree-digit nurnlier; the scripts are llien run in numeric 
order: 

root# Is -1 /etc/periodic/daily 

100.clean-logs 

110.clean-tmps 

130. clean'TUBgs 

430.status-rwho 

500.daily 

randoms ].eep 
600.updateMachineName 
/OO.updateHoslInfo 
900.autoradtiiind 

There are some issues to be aware of, however. The first 
IS exactly when these scripts will run. This is controlled by 
launchd in the following files in 
/System/Library/LaunchDaemons: 

com.apple.periodic-daily.plist 
com.apple.periodic monthly.plisi 
com.apple.periodic-weekly.plist 

Looking at com*apple.periodic-daily.plist: 

<?jcJiil versiui]="l. O” encodlng-^UTF S'*?) 

<!D0CTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 
1.0//EN" “lutp://www.apple.com/DTDs/PropertyList-l.O.dtd”) 
(plist veraion^"!.O”) 

(diet) 

(key)Label(/key) 

<strlng>conuapple.perlodic-dally</string) 
(key>ProaramArgmi!ents</key> 

(array) 

Cstring>/uBr/abln/perlodic</srriTig> 

<string>daily</string) 

(/array) 

<key)LowPriorityIO</key) 

(true/) 
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<key>Nice</key> 

<integ€r>l</integer> 

<key)StartCalendarTntervaK/key> 

<dict> 

<key>Hour</key> 

<lnteger>3</integer) 

<key>Minute'</key> 

<integer>15</integer) 

</dlci> 

</diQt> 

</pliat) 

'rhe StartGalendarInterval key tells us it will run 
each day at 3AS AM local time. That time might not be a good 
one for your environtiienl. Consider a few scenarios: 

Desktop machines: if the desktops in your organization 
are left on 24/7, then the script will run shonly after 3:15 AM 
each day If instead, they are asleep at 3:15 AM, they’ll run 
shortly after they are woken up eacli day. If they are powered 
ofif at 3:15 AM, the scripts w'on't run at all. Launchd will 
reschedule jobs ihal were scheduled to run when the machine 
was asleep, but will not reschedule jobs tiial were scheduled 
to iim when the machine was powered ofl 

Laptop machines: all of the same complications as with 
desktops, with the additional problem that if tliey get taken 
home at night or over the weekend, and run these jobs at 3:15 
AM (or when woken up), and your scripts require access to 
neLwt)rk services or resources available only wlien the 
machine is connected to your organization's network, they 
may fail, or at the very least, fail to do anything useful. 

Therefore, you might consider changing the time these 
jobs run to a time during the day wlien it's more likely the 
machine is on, awake, and on your network. 

Another possible approach that does not require 
modifying Apple’s provided launchd items is to run a .script at 
startup that checks for overdue periodic jobs and runs them. 
Such a script is described (and available) here: 

http://managingosx.wordpress.coin/2008/06/18/launc 
hd ws-periodic/ 

Repeating launchd jobs 

Looking at llie property list for c om. apple, periodic- 
daily.plist suggests another method for running scripts 
on a repeating basis: avoiding the periodic middleman and 
using launchd directly Using our com.mactech,demo 
example as before, we can ntn a .script at starttjp and once a 
day with a LaimdrOaerntm plist like this: 

<7xml version='’K0" encodings"UTF*8"?> 

<jDDCTTFK plist FUELTC //Apple CotnpuLer//[ITD PLIST 
1.0//Ehr' •'http: //www.apple, com/DTDs/PropertyLlst-1.0.dtd") 
<pltst version^" 1.0**> 

<dict> 

<key>l-abeK/key> 

<string>coiii.inact^c:h,demi:></striria^ 

<key )ProgramArgujnents< /key) 

<array> 

<stj:ing>/Library/Managein^nt/ccinfigurat Ion. sh</st ri ng> 
</ar:ray> 

<kGy)RiJnAtLoad < / key) 


<irue/> 

<key>OnDemand</key> 

<true/) 

<key>StartCalendarInterval</key> 

<dict> 

< key) Hoti r < / key) 

^Integer)!2</integer) 
<key>MiTiute</key) 
<integer>Ib</irjteger) 
if diet) 

</dict> 

</plist) 


WeVe added a StartGalendarInterval to the 
previous version of the prt>perly list that tells launchd to run 
the job each day at 12:15, when many of our staff will be at 
lunch, if we didn’t want it to run at startup as well, we could 
remove the RunAtLoad key, or set it to false. 

Good old cron 

One last method to mention: the classic IIMIX cron is 
still available in OS X, and can still he used to run repeating 
jobs. Type man cron at a command prompt for details. 
You’ll probably want to cieate u crontab at /etc/crontab 
. A big disadvantage of using cron is that it’s hard to manage 
different versions of tlie crontab files. For example, if you have 
a set of machines that need repeating jobs A and B, another 
,set that needs repeating jobs B and C, and yet another set that 
needs repealing jobs A, B and C, you1l need to manage three 
different versions of the crontab as well as the scripts that 
do the actual jobs. If you use periodic or launchd, you 
don't have to deal wiili the monolilhic crontab file, as the 
sclieduling info for each job lives in a separate file (or in the 
case of periodic, is not needed). 

To be continued... 

We covered quite a bit this month. We looked at nmning 
scripts at startiip and on a repeating .schedule. In the future, 
we'll kx7k at running scripts as pari of the login and logout 
process, Ixnh with root ]xivileges, and as the user logging-in. 
While you might guess that launchd might be useful here, 
well also look at login/logout htxjks and login items. Well 
also consider the special ca,se of scripts that should run only 
once, either at startup or login. Finally, well look at some 
methods to .simplify implementing additional .scripts once you 
liave a few working. See you next time! 

i\\\ 
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Installer Plugins 

Build a basic installer plug-in using Xcode 




by Jose R.C. Cruz 


Introduction 

Up in new, yoii know two ways to aistoiTii;?t' an tasmll 
scsvskm. For iasiana.\ to chock tf ihc target Lh tlic nglit one for tlie 
[^ayloiid, you use a requirements sciipi. To piepire tlie target to 
receive tlie pay^aicl. you use an action or an iastall scjipt. Yet, there 
are cases wlK^m you may find iticse approaches iriadc*t|uate. To 
liandlc tltosc cases, you may need an installer plug-in. 

This article will give you the Irackground you will need to 
write your own installer plug-in. First, it explains how iIk* plug-in 
fils into ihc Ixusic insuill session. Then, it descrilx.es die ptug-in API 
defined by the InstallerPlugin. framework. Next, it presents 
the plug-in template and its coiistimcnt files. Finally, it shows how 
to huild a basic* plug-in and lest it in a Irasic package. 

As alwiiys, you am gel a copy of tlte featured [mifecls fioni 
the MacTech wel>site. Just go to tlie following LfKL to downkxui 
ycxir copy.: 

ftp.rnoctechxom/src/moctedh/voliime25_2C)09/25.06.sit 

Enter The Plug-In 

Several panels make up a Ixjsic install session (Figure 1). Tlie 
Welcome panel appears 
wlien users start the 
session liy doul)(e-c!icking 
tlie package. 'Ihe .setxmd 
pjinel, ReadMe, provides 
u.sers with more 
infoniiation alxnjt the 
piickage’s payload. The 
third onc\ License. show.s 
the iiianufacturefs license 
tenns governing tlie use 
of the piiykxtd. User am 
citlier rejecl these teniis, 
tlius ending die session, 
or accept them to 
cx)ntinue. Next, die Select 
Destination pane) lets 
users choose the target 
volume on which to iastall 
die ixiykxid. Alter dial, tlie 


Custom Install jxinel allows users to select wliich payload to install 
on the taiget. 'Ihen the Standard Install panel gives users one last 
chance to change their mirxls before die atlmil iastall occurs. 
Finally, the Conclusbn fxinel symmaiizes die results of the 
installation. 

Not all of these p:inels need appear in an iaslidl session. For 
iastanc:e, ihe Readme and License panels aa" optional. Tlie 
install session skips dicse panels if they iuve no text to display. 'Rie 
Select Destination and Custom Install panels iomnge) are 
controlled l>y the piickage. Tlit^ apptfar only if users im: allowed 
to cliangc die laiget volume or clioicv of paykxids during the 
session. 

Now suppose your package need.s extra information From the 
userx, and none of the panels ate up to the task. For tills case, you 
ntxxi to wiiie an iaslaller [liug-in. A plug-in ani insert a custom 
jxmel at s|iecific points of the session (Figiite 2). It resides in the 
directory Content s/Flugins of the ptekage. Also, a plug-in h;ts 
hill access to the Coetja framework. Tills allows the plug-in to do 
a wide variety of tisks, tasks tkit are either dilRcult or impossible 
to do with a script. 


Readme 





welconw 



ItiBttLll 







Licftfise 

-- lACcirpt 1 ’—*■ 

Select. 

DCSLinaLion 

'V 










INSTALL 

HAYLOADS 


/ 




•# 





^ tr; D—^ 




Figure 1. Sequence of panels in a basic install session. 
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Yet, like any s(.)ftwarti teehnolcjgy, an installer plug-in lias its 
limits and issues. R)r one, it cannot replace any of tlie basic install 
panels, A plug-iii must always provide a panel - paneless plug-tas 
are not supported. Also, you atnnot dttbug a plug-in itsing Xcode's 
sountx" delrugger. Your only secourse Ls to liave t!ie plug-m send 
debug messages to tite console - log file using eitlier NSLog () 
or ASL (Apple System Log). Another issue is that only meta- 
packages and distrilnition packages .support instiiUer plug-ias. Tlie 
new nat-rile Leopard package dex^s not support tliem at this time. 

Last of all, at tlte time of writing, the plug-in Al-^l is still pcx>rly 
doaimenretf Ycnir only options scr far are to smdy the header files 
in die InsiallerPlLigin frainework, and tJie sample pliig-in [project 
fixrm Ai)]:>le. 



FigMre 2. A plug-in in an install session 

The Plug-in Framework 

Tile InstallerPlugin framework serves as ilic liasis of all insuiller 
plug-ins. This framework is located in 
/Sys tem/Library/Framewo rks of the OS X IxxK volume. The 
framewtirk comes with four header files, one of which, 
InstallerPlugins.h, is the main header. 'Itie other headers 
define three classes your plug-in can tuse* Figure 3 shows how these 
ckm^ relate to each fxher. 



pkg-in 



Ihiti 1 LvrPlo^in. f rc^wiaark 


Figure 3. The InstallerPlugin framework 


To add this fniniework to your Xc^xle projeti, seletl the 
Frameworks and Libraries grrnip on the Groups & RIes pane of 
tile editor window. Ch(xjse Add to Project from the Project menu, 
and use tlie Open RIe dialog to select the framewTjrk. Gick the Add 


liutton to include the framework to the project. Ihen add the 

following fine to your lieader file 

IflHfKprt < Installer Plugins/Inst a Her Plug! ns - h> 

Lei as now examine what eucli class lias to offer. 

The InstallerPane class 

Tlie lastallcifane dim (Figum 4) handles the display of the 
custom panel. It also numages the interadions between the panel 
and the users. In short, this dass serves as the c:oniroller for that 
paneL 


Ina t a ilorPoiiD 


D[iticrt.s 

^ irontentVleif i^SVicnr 

- ijiltlalKoyViDvtttSvicv 

- wsVi€ii 

- laaLlEcyVlFwiNSVlim 

- ae3it^aiM5ii3i*t*llcrF*ne 

- piiureRtS«;tJ.oilrif id 


- prlv«tet lnatftXlftrPaiic_Fri»ata 



+ sec?;iaRi J rHnstallcrs&ctlon 


HMvignttco, delegates 

4. iiid£ate£F&:ie(anir t laBtallersectioftDl recti on j 

* ghocldExitPAnofftnirsiastaLIersectJLos^ircirtiort} iSOOL 

* willEKltPane^ aoir tinatallersectionolreotion) 

* didExi LFdae {t installerSfic t lOOD irecties} 

+ setWextEnoblcdfaFl^iBOOLl 

* nex tE.nabl ed o ^ BOOL 

^ D etPrevieusEnabled(nrI9 1 BOOL) 

^ ic ajtrnab l f-d (1 1 BOOL 

f ^DteS^MlPazief > iBOOL 


Figure 4. The InstallerPane class 

The ckiss has six private outlets, four of wliich give tlie views 
that are linked to tlie class. For instance, the con tent View outlet 
is the jianel itself Ihe initlalKeyVlew outlet is the first conm>l 
widget that gets user f(x:us after ilie jxinel is disfikiyed. Tlie 
firstKeyView outlet fxiints to tlie cTitrent widgcT tku gets any 
keylxraid events, while the lastKeyView outlet points to the I:lsi 
widget to get any events. 

Tile next Pane outlet letunis die installer piuiel tliat follows 
die current one. And die outlet parent Sec Lion rerurns the 
InsmilerSection instance for that panel (mom on dtis laier). 

Tlie TnstallerPane class also comes widi a wide range of 
messages. In tliis article, we will fexus only on those messages diat 
deal widi panel liehavior ihere are eleven of these messages, 
which falls iincler twri groups. Tlie first group cT>asists of delegate 
messages dial the class gels at each ]ianel event (Figure 5). 
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The InstallerSection class 



Figure 5, Panel events and delegate messages 


15efore tl\e [ijancl ap[X."ais in Uic instil I .scssiun, it sends a 
willEnterPane message to the InstallerPaiie class. Tliis allows 
the class to prepiire the resources it needs to siipfxjrt the panel. 
Next, tlic fxinel appears and sends a title message to tlie class. 
Ilte class responds with a Itxalized NSSthng, which the fxmel 
displays ne^ir it.s upper-right comer llien the panel sends a 

didEnterPane Lo the class. The latter am respond eifiier by 
setting tlte dciaull values t>n tlie fxmel or hy starting ihe desined 
services. 

W[)cm users click the Go Back or Continue button, the p;mel 
first sends a £5houldExltPane to the InstallerRme ckss. If the 
dass tetiims a KO, the panel remains active. On the olhcT lumd, if 
the class nemrns a YES, the piinel sends a willExitPane back to 
tile class. Tile class uses this moment to prtxt^ss the user dtiia from 
the panel. ITie |>ane] tiien disapjx^ars and sends a didExitPane 
liac'k to the class. 1tiis Is where the class can dispose the resources 
it used lo support the panel. 

llie second group of messages allows tlie InsuillerPane class 
to a)ntrr>l some panel activity. For instance, to enable tlie Continue 

[>ution, .send a setNextEnabled message with a YES argument, 
[seif setNe)ttEnabled:YES] ; 

To read the state of the Continue button, send a nextEnabled 
message. If ihe iiniton i,s enabled, the message remrns a YES; 
otherwise, it returns a NO, 

tFig - [atlf iieKlKiiabled]: 

To dispkiy the next panel, use the gotoNextPane messiige. I'or 

the j>Tevioas panel, use the gotoPreviousPane message. 
tFlg “ [self gotoNextFane]; 

These messages have the same effect as users clicking the Continue 
or Go Back buttons. FkHh renim a YES if the desired panel app^irs 
without enors. On the otJier liand, if tlie panel does not exists or if 
an error occurs, Ixith messjiges return a NO. 


Next Is the Instailerfieditm class (Figure 6), which works as a 
cxxitroller for InslallerPane. It suptilies tlie plugdn with data on die 
current install session. The InstallerPane class carries an instance of 
InstallerScxiion in it.s parentSection outlef. To access the 

instance, send a section messiige from lastallcTPane. 
iSct - [:Jelf sectionl; 


Ins t allo rsoctioa 

^ firstPanciinatallerPane 
propiertlefl 

- private jla&tAllersection^Privat© 

^ bundlet>tNSBundle 
+ titlei)iSSStrtng 
+ sharcrdDictionaryO sfiSOictionaxy 
+ installerstatet)?tallerState 

+ shouldLoadl) t iOOI* 

+ willl.oadMalfiHlbt) 

>1' dldLoadMainsiibr) 

+ firstPaneC)sinstallerPane 
+ ae tivepa no()^inat allerPane 
+ go top one (pane; las tallerPaiie > ( bool 


Figure 6. The InstallerSection dass 

11ie Lnstallei*$eaion class has one private outlet, firstParie. 
Tltis outlet stores an insiancc of the Insrallerl^me class. By dehiult, 
tills Is tlie same IrLstallerPaiie wIkm.^ the aislom pane! apiX'ars 
during the iastall sesskjn. Since thus outlet exists, it implies that a 
plug-in c:an have multiple iastances of lastallerPane, each one with 
its own ciLstoni panel. We will explore this possibility in a hiture 
artide. 

Next, the InstaUerSeclkin class cumes witli ten methods, some 
of whk ii you ain ov’erritle. Tliis ankle, howm^, will tcxTis only on 
lht)se metliods lliat a Ixusic f>lygdn can u.sc. For in.siance, to get tlie 
cTjnent pLinel use the first Pane w activePane metliod. Eitlier 
mellitxJ will return the .same InstallerPune instance if the plug-in has 

only one cu^oni panel 

tPnl - [[self seeiion] ftrsiPaee]; 

To get the nib that ouries the custom panel send a bundle 
meSsSage to tnstallcrSeclitni. This mlurns the [>yndle as an NSBundlc 
object. 

tBncil = [[j 5 elf section] bundle]; 

To read die title string for the active panel, call the title metlKxl. 
ItisuiIlerSeoion responds by anuniing tlie |yand title as an NSString. 

tT-itle ^ [[self section] liile]: 

And tt) find out the ciirrenl install stale, use the state accessor. 
Tliis gives you an instance of the InsiaycrSuite class, which is 
descrilied next. 

tState = [[s&lf section] statej; 

The InstallerState class 

As stated earlier, the InstalletSuite class (Figure 7) returns the 
oirrent state of the install .session, like lasiallerSetikm, this cia.ss Is 
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insUmtkited by InsUiUerPane onoe the latter displays its jiianel. To 
access the instance, use the state accessor of InstallerSeciion. 


Xnstulloiretato 


- private t installerState-Private 


+ IiconseAgree d O ^ bool 
+ licenseAgreedl>aeguage() sUSString 

+ t arge tP a th U:HBString 
+ targetVoluraePath t >iNSString 

+ cftoieoDictionarioG { j .^NSArray 
choiccDictionaryForldcntifier 
faniDinsetting}sKSDictionary 

^ iiiBtallStartedt J imx>L 
+ in stall Succeeded (); BOOL 


CustoinLocation. And the choice state is under the key 
IrLStallerState_Choice_Tnstalled. Figure 8 shows which 
field on itic choke’s Configuration panel corresponds to which key 



Figure 8* Hie choice states and their keys 


Figure 7* The JnstalferState class 


The Plug-in Template 


There are lour sets of meLhtxis in the InstallerState class. Rat:h 
set coii^ponds to a s|xxific stage in the install .session. Tlie first set 
returas the results of the License panel, lb find out if users 
at:cepted tjie lit:ease terms, u.se the 1 icensaAgreed method. Tlie 
metlKxl retuois a YES if users did accept the icnns; otherwise, it 
leturns a NO. 

rAgree = [[Tself secTjon] state) licenacAgreed]: 

To find out which localized lieeasc is displayed, use 
licenseAgreedLanguage. I'liLs niediod returns tlie language as 
an NSString. 

tAgrse = n (self section] state] licettaeAg^reedLanguage]; 

I’he secemd set of metiKxls return die resalLs of tlie Select 
Destination panel, lliey tell the plug-in wheie the package w'ill 
insuill its payload.s. To get ihe .seleded target vc^Uime, tise tlie 
targetVolumePath meljitKl. 

tVol = [ [ [self s^ctioiij state] targetVolumePathJ ; 

Hie melhcxl returns the inounl |X)in! of the selected volume as an 
NSString. To get die final destination for the payload, call the 

target Path metlicxl. 

tPth - [|[Be]f section] stale] targeLFaih]: 

This returns die destination’s ahsolnte path ais an NSString. Hie 
leturned jxith will also have the volume’s mount jxiint as f)art of its 
string. 

The next .set of metlicxis give the results of the Custom Install 
[laticl. They tell the fiiug-in which payloads wlierc clKisen hy the 
users. For a list of all payloads, call the method 
choiceDictlonaries. 

tList ^ I[[self section] statel choiceDictionaries]; 

Hie nietliod returns its list as an NSAiray. For a specific payload 
choice, use the mediocl choiceDictionaryForIdentifier. 

Then fia.ss the payloads citoice ID as input. 
tPayload = [[[self section] state] 

ChoiceD let 1 ona ryForldlen t i fIcr fooba r " ]; 

This returns the choice settings as an NSDictionary, There are three 
entries to diis dictionary', eaeli entry' widi its own uniejue key The 
choice ID, for instance, uses 

Insta] lerState_Choice_Idenlifier as its key the 
payload’s dosLinalion path Insta 1 lerStat e_Choice_ 


To create an installer plug-in, use the Xcode project 
template, aptly named. Installer Plugin. Xcode 3.0 files tliis 
template in the directory 

/Developer/Library/Xcoda/Project 
Templates/Standard Apple Plug-ins. You can, of 
course, write your own plug-in project from scratch, Using the 
template, however, reduces the amount of guesswoi k on your 
part. 

Figure 9 shows the bundles and files of the project 
template. Note that there are two project bundles: one with a 
, xcode suffix, the other .xcodeproj. Use the 
^xcodeproj bundle if your Xcode IDE Ls version 2.x or 
newer; use the , xcode bundle for older versions of Xcode. 


, ■.ml 

1 i 1 «rPl U9 in. voooepro j 



N<3te also that ihere are only three items that you should be 
updating. The rest of the project items have default settings 
that will suffice for most cases. 
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■ License transfer by SOAP based CM-Talk or file based Field Activation Service in e-shops. 

■ Multiple-purpose, including protecting low cost software and digital content. 

■ Unique End User Advantages 

■ First and smallest dongle with up to 2 Gbyte flash drive. 

■ No drivers necessary - can be used without administrator rights. 

■ CM Password Manager, secure virtual drive and secure login. 


Order your Free Software Development Kit now! 
Phone 1-800-6-GO-WIBU | order@wibu.us 
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■ New Distribution Channels 


■ Highest Security 


■ Vendor selectable secret and private key. 

■ Strong encryption algorithms with AES 128-bit and ECC 224-bit. 

■ Best-in-class tools for automatic protection (envelope, without source modification) 
for Win32, Win64, .NET, Java and MacOS X Universal (PPC, Intel). 

■ Best Flexibility 

■ More than 1000 independent licenses can be proterted by one CM-Stick. 

■ One versatile hardware key for ail license models including floating network licenses. 

■ Multi platform support including Windows, MacOS X and Linux. 
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The InstallerSection.plist file 

This nic defines wliere your eusLom panel will appear in 
the install session. This file must be placed in the 
Contents/Plugins directory of your installer package. 
Without this file, your package will ignore your installer plug¬ 
in. 

U.sting 1 shows the default contents of that file. Note the 
file list only six of the panels that appear in the install session. 
Tlie first tlircc on the list refer to the Welcome, Readme, and 
License panels. The Target entry is the Select Destination 
panel, and PackageSelection is either the Custom or 
Standard Install panel. Finally, the Install enlry is the progress 
panel, which appears when the package starts installing its 
payloads. 

Listing l*The InstallerSection.plist file 

<?xml versiDn=” i. 0 ^ enc.odina="UTF - 3 "? ) 

(IDOCT^PE plist PUBLIC "’//Apple Coniputei://DTD FLIST 
1.0//EN" "http: //www.appl e,com/DTHs/PropertyLlst 1 *0.citd'’> 
(plist version="l.0") 

<dict> 

<key>SecrionOi:der < / key > 

(array) 

<striii^>Introductlon( /string) 

(strltig>ReadMe(/siring) 

(string>LicenBe(/string) 

<slring)<PKOJECTNAMii>*biiridlc</striTig> 

<strliig)Targat</string) 

<strliig)PackageSelection(/string) 

(string>In3tall(/string) 

(/array) 

(/diet) 

(/plist) 

Note as well that the file places the plug-in l>eiween the 
License and Target entries. It also lists the pkig-in under 
the generic name of PROJECTNAHE. When you create your 
plug-in projeel using iliis template, Xcode replaces 
PHOJECTNAME with your pkigdn’s name. If you move your 
plug-in's entry in the list, you change the position of its panel 
in the install sesskm. Also, if you delete one of the entries in 
the list, you prevent that panel from a]>peanng during the 
session. But be careful with this last step^ as it may lead to 
u nexpected res u 1 Is. 

The InstallerPlugin.nib bundle 

This bundle defines the look and feel of your pkig-in's 
panel, Like all nib bundles, you use the Interface Builder to 
make changes to this bundle. Figure 10 shows the five default 
objects in thi.s bundle. Two of the objects are for your plug¬ 
in's use. For instance, the View object is, obviously, an 
instance of NSView. 1 his object carries the interface of your 
caistom panel, l^oiible-cUcking it gives you an empty panel 
that is 41H pixels by 330 pixels in siic. Do not, however, 
change the size of the panel If you do, your interface widgets 
will appear misaligned during the install session. 
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Figure 10. The liistalleiT>iugin.iiib bundle 


The «PROJECTNAMEASIDENTIFIER»Pane is an instance 
of InstallerPane. iLs name is set to tlie project’s name after you 
create the project. For instance, if your plug-in project is 
Foobar, the InstallerFane object gets the name FoobarPane. 

The other three objecLs are the usual proxy objecLs yt>u 
find in most nib Ixindles, But in tliis nib, the Filers Owner proxy 
refer to the instance of InstallerSection, Its one outlet, 
first Pane, is linked to the nib’s InstallerPane instance. The 
Application proxy refers to the global NSApplication object, 
which will be the Installer utility for the plug-in. And the First 
Responder proxy refer to the first object In the responder 
chain. This proxy is currenily nt>i auached to any object cmi the 
nib. 


Tbe Pane files 

Finally, there are llie two files: Pane. h and Pane, m. 
The.se files define die InstallerPane controller for your panel 
Again, when Xctxle creates yemr plug-in project, it prefixes the 
prtjjecl name to each file. Do not, however, change the assigned 
file names to something else. If you do, your plug-in will lie 
unable to di.spiay Its panel correctly. 

Treat these files as you would any controller class files, Ftjr 
instance, you can add outlets and link them to specific widgets 
on the aistom panel, You can define actions that your panel 
widgets can call at runtime. You can even add code to 
manipulate user data or pass that same data to your own 
custom model class. 

CAVEAT 

At the time of writing, the plug-in template has one 
interesting Haw. When you use it l;o create a project, the 
project’s nil) bundle loses all six outlets R^r its InstallerPane 
instance. Your plug-in will still work with this flaw present, but 
it will be unable to query the current install state. 

To work around this flaw, save your nib bundle as NIB 
2.x. With a text editor, open die file classes.nib that is 
inside your bundle. Then add the lines in Listing 2 to that file. 
These line.s will restore the six outlets to your bundle. Save your 
changes when done. 

Whether diis flaw is fixed in Xcode 3.1 is unconfirmed. 
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Listing 2. Adding outlets to classes.nib 

<key>OUTLr:TS< / key) 

<key> coat ent V i ew</key) 

<String>NSView(/string) 

<key)tirstKeyView</key> 

<st r1-ng>NSVlewC/ string) 

<key >initiaIK e y View</key) 

<s t ring>NSView</string) 

<key>lastKeyView</key) 

<string>NSView</string) 

(key)nextPane</key) 
<stTliig)TasiallerPane</string> 

<key)par eatSectIonC/key) 

<string>ldC/string) 

</dict) 

To Create A Plug-in 

Let us now build a simple plug-in using diu Jnstallcr 
Plug-in remphte. Our plug-in will ask users to enter their 
name, company, and product serial numl)er during the install 
session. If the serial number Is correct, the plug-in will enable 
the Continue button. Otherwise, ii will display an alert dialog 
and disable the same buLiojc 

So, Stan up your copy of Xcode. Chtx>se New Project 
from the File menu and pick Installer Plug-in from the list of 
project templates. Click the Continue button and set the 
projects name to Register. Leave the project's directory at 
tlie default location. Click the Finish button u> create and 
open your new project. 

Defining the panel 

Select the entry RegisterPane .h from the Groups & 
Files pane. Add the following outlets to that file’s 

^interface block. 

tBOutlel NSTextField ‘ollser: 

IBOutlet HSTextFieid 'oCorapi 

IflOutlei NSTextPield 'oSerial: 

Then add the following action to the same block. 
fTBAction) cegisterCheck;JidJaSnd; 

Next, double-click the Regis ter, nib entry from the pane, 
thus opening the bundle in Interface Builder. From the 
Register window, select the icon 
«PROJECTNAMEASIDENTIFlER»Pane. Choose Identity 
Inspector from the Tools menu and set the Class field tu 
RegisterPane. Scroll down to the Interface Builder 
Identity pane and set the Name field to Register Pane. 
Save your changes by choosing Save from the File menu. To 
find out if your changes are crorrecL, go to die Class Outlets 
pane of tlie paleiie. You sliould see your three outlets listed 
in diat pane. Close the palene when you are done. 

Now double-click the View icon on the Register 
window. I^y out the panel as shown in Figure 11. There are 
two sets of widgets on the panel. 'Ibe first set con.sists of 
NSTextFields serving as static labels. The .second set consists 
of NSTextFtelds serving as editable fields. 


provide: tbt following rtgi&triitton tnform^tkiii 
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Figure 11. Layout of the oistom panel 

Selett the RegisterPane iran and choose Connections 
Inspector fmm die Tools menu. With your pointing device, link 
each editable field to the right <Hjdet (Figure 12, md). For dits |>lug- 
in, the oUser outlet links to die User field, the gComp to the 
Company field, and o Serial to Serial, 'llien link all three ediiable 
fields to the register Check action (hlmd. Take otc to leave the 
template's preset links alone. Save your dianges and switch Ixick to 
the Xcode edilon 


C ... L. _. 

•- ^ 



Implementing the panel 

We now enter the code-writing part of the projeti. Sclea die 
entry RegisterPane .m from die Groups & Files pane. Go to the 
delegate meihtxl didEnterPane and enter the code shown in 
listing 3. Tills method sets each the rxitiets to their default values. 
Tlien it disables the Continue liuiton and enables die Go Back 
Ixitfon. 

Listing 3- Setting the default panel data 

' t void )cjidEn ter Pane: (irisiailerEHectlatiDirectionjaDIr 
{ 

/ / kiitialke the following outlet fields 
[nUset aetStringVallie;#'*your nawe goee here*]: 

[oContp setStriiigValue:#'’yout cg>fi|>ariy naine*] ^ 

[aSerlal setStringValue:i*l2345678S"l: 

/ / disabte the Ct>ntiTiue button 

[self GetNextEnabled:MO]; 

/ / enable the Go Back bulton 
[self f?etPrevioiisEEtflbled:YESj: 

1 

Next, enitT the axle in Listing 4 to the delegate mt^thcxl 
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shouldExitPane. First, tlie meduxl rends die hash vnlues from 
the oUser nnd oComp oiidets. It then cx^mfoines tlie two luisli 
values and compares the results with the value from oSerial. If 
ix)th values are different, die mediod displays a warning dialog to 
the users. It then disables the Continue (xitton and leiums a NO lo 
pjevcnt die panel change. On die other hand, if Ixidi values are die 
same, the method returns a YES to allow die change. 

listing 4. Checking the user data 

- (BOOL) show IdEjd. t Pane r t Insta 11 e rS ec t ionDi rec t ion} aD i r 
I 

NSUIntegtjr lUat* tCmp* tXor. tSH; 

NSAlert *tWrn: 

/ / dKck die dlreiddon of movement 
If (aDlr ItiatailerDirectlotiForvard) 

/ / read die hash values of eadi registration 
tUsr = I [oUser stringYaltinl bash] i 
tCmp “ [ toCemp stringValae] bash]: 
tXor - tUsr tCmp: 

/ / read the serial number 
iSN * [oSerlal intValue]; 
if ttSH !- tXor) 

* 

/ / create a warning dialog 
tWrn [ [NSAlert alloc] itiltj: 
if (tUm != nil) 

I 

/ / initialize the dialog 

[iMrh addauttonWlthTltle:e"OK-l: 

[tWrn aetMessageText:^"Invalid serial 

number^]; 

[tVen fietinformatlveTexlJ 
^"please check and re'enter your regiatrstion 

information."I i 

liWrn 

setAiertStyle :NSInforHiational AlertStyleJ: 

/ / display the warning dialog 
[tWrn runHodaij: 

/ / dispose tl’ie warning diaU^g 
ftWrn release]; 

I 

/ / disable the Continue button 
[acir setNextKnabIed ;tiOj; 

/ / prevent the panel movement 
return (NO); 

1 

I 

/ / alkw the panel movement 
return (YES); 

I 

Finiilly, to die registerCheck action, enter the code in Usiing 5. 
This acdon checks die data in each mitlet. If all oudets have a non¬ 
zero length string, die acdon dicn eoahies the Continue kitton. 
Odierwise, that sjtme button remains disabled. Save your changes 
after you liave updated these three methods. 

Listing 5- Rt?sponding to the user entry 

(IBAc tionJ ra gis terCh^ ck:{id,aSnd 

\ 

BOOL tChk: 

// check the registration fields 
tChk = ([foUser sLringValueJ length] ) 0): 
tChk 6(* (ItoCoinp striagValtje] length] > 0): 
tChk ([[oSerial stringValue] length] > 0): 


// enable the Continue button 

fself setKexrKnabledaChk]; 

) 

Now, a few words befoie we proceed to die next jiart of our 
project. Fiisi, note die use of the NSString hash function to generate 
die values for oUser and oConip. Wliilc diis function Ls fine for our 
sample plug-in, it Is impractical for real-world use. Future veisions 
of NSString may lx:have diffeiendy. As a result, their fmh functions 
may netum a different value for die siime string. A more reliable 
solution is for you to use your own hash algorilhin. 

Second, the plug-in only checks if the registration data is valid 
liefore it allows or deny prtxlucl installation. Tliis, again, is 
inipraaical bet'ause users can defetit the check l>y lemtjving the 
plug-in. One g^xxl solution is to have the plug-in write its results to 
a hidden file. The installed payload can dien kxjk for this file and 
even read its data. If the data is correct, the payload liehaves 
nomiaily. If not, or if the file missing, the payload displays a 
reminder dialog or it runs in dtrmo mcxle. 

Building the plug-in 

We are now ready to build our plug-in. But first, we must 
define wherc* our plug-in's panel will appear in the insUdl session. 
In this case, we want our panel to come after die Select Destination 
panel. Select the entry InstallerSection.plist fiom the 
Groups & RIes pane. Locale die entry Register, bundle and 
move it after die entiy tor Target (Usdng 6). Save your changs 
when dime. 

listing 6. Modified contents of 
InstalletSection.p]ist 

<arrfly> 

< s t r i iig>l nt roduc tion < / s t r ing> 

< s t r 1 fig>Re adMpX / s t r Ing^ 

<5triiig>Liceiise</atring> 

<string>Target</atring> 

< s t r iiig>Re gi s te c * bundl e< / string > 

<3 trliig>P3 cka geSe 1 ec t i on< / s t r ing> 

<string>InataJ.J.</st rii)g> 

</array) 

Now build die plug-in li>' clicking the Suiid button on die 
Xcfxle tooilxar. Xcode ct>nipiles each project file and links dictn to 
create die plug in bundle. It then places die bundle, named 
Register .bundle, in the in the project subdirectory 
build/Release/. 

Installing and testing the plug-in 

To test die pliig-ia you will need a Ixisic installer package. 
Now when you prepare your installer prtijea, make sure to set iLs 
Minimum Target to MacOS X 10.4. ^Ihis will tell FackagelVLiker to 
use the distribuiion bundle as die f>ackage format. 

in diis article, we will ase Foobar. Deino as oui iasialler 
pitijm. iLs payload cxiasLsts of’ three T1H‘ files, which v^Hl go into 
the diieacHy /Users/Pictures. Build die package by choosing 
Build fk>m the Project menu. Wlien piomplc'd, use Foobar as the 
package name. Go to die Finder and ainuxil-dick die package to 
display its contextyal menu. Choase Show Package Contents to 
open the bundle in a .separate Finder window. Go to the 
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Contents dinettoiy tmd cmtie s new' siihtiirmory mimed 
Plugins, Tlien copy llie plug“in Register .bundle und tJie file 
InstallerSection. plist into dm sulxluectory CPi^ire 13). 
Close die Hinder w^Lndow when clone. 
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Figure 15. Jnslalling the plug-in and plist 


Now ckuible-click the Foohar packige to start die install 
.sesskin. First, you get a m<Kbil dialog (FigurL‘ 14) warning y<xi tlial 
die jrackage will (x^rfonn a custom task. Tliis iiiems die package 
recc>gnizes your plug-iiis presence. But it can also mean tFuit the 
package aintaias an iastall atiion or .sc'iipi. Click Continue to 
pnxced. 



This package coniarns a program that 
Cteterfnlnes if the saftwafe can he 
installed- Are yhu sure you want to 
continue? 


It you're nm sure about tHe source iliti package. 

Cancel to p’^c^ent it froin runmns the pnjgriih 
and instalUng the ^ftwarc. 

f Cancel "^ ( Continue ) 


Click the Continue button until you reach die Register panel. 
For die User field, enter the name "'Alrm Sniithee" as the iLser, For 
the Company fields enter “Ft>obar''. Ijeave the Serial field 
unchanged. You should see dx Continue liuiton enabled at diis 
ixiint. Now click that button. The package will dispLty a warning 
dialog (Figure 16) telling you that the reglstraiion ilata Ls wn)ng. 

Dismiss the dialog by clicking iLs OK buiion. Cirefully type 
L239302760 into die Serial field and then click the Continue button. 
'Ihis time, the pickiige will display the next panel, w'hich is the 
Custom Install panel. 


i 

lovatld facial numbtr 

ctiick .m? rt ' t iftt * fCw 


Figure 16. Incoffect registration 

Concluding Remarks 

An iastaller plug-in is another way to aisioinhcc your itisCall 
.sessk>n. Wiih a plug-in, you cTiii display a aistom panel for other 
users to intenid;. You can use the Qxoji framework to do tasks that 
are hard, if not impossible, to do wndi an action or scripL 

Xt:ode comes widi a Ixisic template that you can base your 
pLig-in project. Tliis template sets die necessary files and nibs 
needed for such project. Adding a plug-in i.s as simple as a drag and 
dmp. But keep in mind diat only a meta-package and a distribution 
jxtekage will use plug-ins. The new^ flat-file package, introduced in 
i0.6» will ignore any plug-in.s it may curry. 


Figure 14. Warning the user 


Recommended References 


After the package displays it.s Welcome panel, you wall see the 
name Register added to the list of paneis (Figure 15, omn^l You 
will also sec dial .same nanx after Destination Select, TliLs meiins 
tile package knows tliat the plug-in lias a aistom panel, and it 
knows when to display the panel. 



Figure 15. The Welcome panel with an updated list 


As slated earlier, Apple lias yel lo dtxunxnt tlie task of writing an 
installer plug-in. So far, your best optioas, besides this article, are ro 
study tlieir sample plug-in project, or tlie he;ider files of the 
lastallerPlugin framework. You can also tjuery die lasUiUer-dev list 
archives for possible answer to your questions, 

Stephane Sudre, maker of Icelxrg, also wrcXe a couple of pitx'es on 
the topic. Listed below are his online works for your IxncTit. 
,Siepfiane Sudre. “Defining Installer Plugins”, icehe^^ Users Guide, 
Copyriglit 2008. AcceSvSed on 2008 Aug 14. Dnline: 
hltp://s.sudmiree.ff/SolWire/!ceb€rg.html 
Stephane Sudre. “Installer Plugins”, fmtaliation - The iosf Scrolls. 
21X)8 Apr 10. Accessed on 200B Au8r 14. Online: 
http://s.suctre.frBe.fr/Stuff/lnstailer/[nstal{er_Ptu9rns/inclexhtrnl 
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Small Tree’s Edge-corE ES4548D 


Cost effective, high-bandwidth switch for your network 

By Dennis Sellers and Neil Ticktin 



Small Tree's Edge-corE ES4548D 


The Need 

Everyone talks about wirele^ss, but when it comes to fast, 
reliable, irouljie free conneeiiviiy, a wircil Fihernet cnanection 
is still king. All of Ap[3lc’s muehines come witli gigabil 
Ethernet, but that's only part of the solution. Sure, there are 
cheap 5-port switi^hes, but what if you need 24- or 4K-ports? 
Gigabit for all those ports? I i'll cost you an arm and a leg^ right? 
Not necessarily. 

MacTech has lx*en using a solution in house, and put it 
tliroLigh a variety of real world scenarios and every day use for 
a sustained period of time, 

Enter Small Tree's Edge-corE 
ES4548D 

If you need a 12 Gigabit Hthernet swiich for bandwidth- 
intensive networks you might check out Small Tree's Edge-corE 
ES4548D. It's designed for netwT>rks that need advanced 
switching features sucli as line-nite rare performance, dynamic 
802.3ad link aggregation, IPv6 sup[)orL, security, fiigh 
availability and advance QoS to ihe network edge wlule 
offering the simplicity of traditional LAN switcliing. 

The Edge-Core ES4548D is designed kjr high performance 
server aggregations, such as enteq^rise data centers, lo connect 
high-end or nemork attached file senders over copper ports. 
High-speed workgroups Ivackbcjne upgrades, and Gigabit to 
the desktop for power users. Tlie whole stack can be managed 
as a single entity with a single IP address. 


The ES4548[) sports 44 x 10/100/1 OOORase-T + 4 Gigal>it 
Combo (RJ15/SFP} ports with Gigabit Ethernel link on all ports. 
Its advanced QoS features are for "triple play" [^erfomiance, 
while the switch is very scalable. It has a forwarding rate of 
71.5Mpp.s, a MAC Address Table size of 8K and a switching 
ca]>acity of 96GI>ps. With its 96Gbps switching capacity, the 
ExS454Bl) delivers wire-speed switching perfoiinance on all 
gigabit ports, Ihere are four Gigabit Ethernel combo ports for 
uplink Oexibiliiy, allowing copper or fiber uplinks. 

IEEE 802,Iw Rapid spanning 'free Protocol provides a 
loop-free network and redimdam links to the core network 
witli rapid convergence. IEEE 802.1s Multiple Spanning Tree 
Protocol ains STP per VLAN l>ase, providing Layer 2 load 
sharing on redundant links. IEEE 802.3ad (LACP) is designed to 
increase [>andwidili by automatically aggregating several 
physical links together as a logical trunk and providing load 
balancing and fault tolerance for uplink connections, 

IGMP snotjping prevents IkKiding of IP multicast traffic 
anti limits bandwadth intensive video traffic to only the 
subscribers. 

Comprehensive QoS support with 8 egress queues per 
port enafjle dinerenliated management of up lo eight traffic 
types. 'IValfic is prioritized according to 802. Ip, DSCP, IP 
precedenc^e and TCP/LIDP port number; the goal is to give 
optimal performance to real-time applications such as voice 
and video. Asymmetric liidireclional mte-limiting, per port or 
per traffic class, preserves network bandwidth and allows 
maximum control of netw'ork resource.s. 

IEEE 802,lQ-in-Q allows die service provider to provide 
certain semces, .such as internet access on specific VLANs for 
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Web Interface 


nspecific' ai.'itomers. It provider other 
types of services for their other 
customers on other VLANs. 

Pon Security ensures access to a 
switch port based on MAC address. IHHR 
802dX port-based or MAC-based access 
control makes sure that all users are 
authorized before being granted acces,s 
to the network. User authentication is 
inipleinented via any sta[idard-based 
RADIUS server. Access Control lasts 
(ACLs) can i^e used to restrict access to 
sensitive network resources by denying 
packers based on source and destiriiJtion 
MAC addresses, 11^ addresses, TCIVUD!^ 
jx)rts. 

SSL, Web Management Encryption, 

RADIUS and TACACS+ are designed U? 
protect data cuinmunication and ensure* 
data privac 7 . What's more, Private VLAN 
i,solales edge ports to ensure user 
privacy. 

You conligure the ES4548D by using 
the web-based graphical user interface. 

Industry standard Command Line 
Interface (CLl) via console port, d'elnet or 
SSH provides a common user interface 
and command set lor users to 
manipulate the switch. 

Four groups of RMON are 
supported. You can back-up and restore 
firmware and configuration files via TFIT. 

The ES4548D supports IPv6 management, QoS and 
security to help you get ready for future transition to IPv6. IPv6 
can suppoit an exponentially greater number of IP addresses 
compared to lFv4. 'Lhe internals of the lFv6 protocol have been 
designed for scalability and exiensibiliry. d'his means that a 
variety of different kinds of devices l3esides computers, such as 
cell phones and home appliances, will be able to more easily 
join lhe Internet in fuiure, aca>rding to the folks at Small Tree. 

The ES4548D lists for $2,024. Also, Small Tree ofiers an 
optional redundant power supply for the ES4548D that provides 
uninterrupted power. 

http:// WWW. s ma 11 free, com/ Edge_corE_48_port_L2_G i gabi t 
_StandalQne_Switch_p/ es4548d.htm 

But, Is It Worth It? 

All the details are nice, but the end result is what Ls really 
imptjrUint. Is it worth upgrading 100 Mbps swatches to GigabiL^ 

Nut every application can take advantage of the faster 
bandwidth, but in our testing, some of the most burdensome 
network issues (such as backups and file cropies) really fly. In 
real world scenarios, we continually saw a 4-6x speed 
improvement over what 100 Mbp,s delivered under the same 
scenarios. Even interaction with the email servers when 


sending enclosures w^as noticeably faster. We often saw 
backups run, even with .slower machines as clients, at nearly 1 
gigabyte per minute (i.e,, approximately 480 Mi>ps). 

So, is it wonli it? Definitely. At least that's w^hat we found 
with Small IVee's ES4548D. You get the performance of some 
of lhe ‘'name‘' brands, for a reasona[)le price, 

i\\ I 
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Etymotic 
etyBLU 

Headset 

By Dennis Sellers 

Tlie folks at Etymotic say tlicir etyBLU 
(http://www.etymotic.com/ephp/etyblu. ospx!) 
was the first BluetcxDth headset that features a 
connecting noise-canceling boom 
niicrophone. Desc'rilxfd as a “dual mode'’ 

Bluetooth headset, it comes with a noise 
canceling lxK>m microphone (the BlumaKX 
Quick-Connect Microphone, which enables 
callers to be heard clearly and understood) 
and an internal niicnjphone. Ycju can use the 
latter independently siniply fjy unplugging die 
ixioni microphone. As for the BliiMaxx, if 
gives you up to 25 dccilx^ls more noise 
cancellation compared to the internal 
microphone. 

When it’s connected correctly, the 
opening al the tip of the microphone is closest 
to the mouth and llic opening at the middle of 
the microphone tip faces away from the 
mouth. You can connect or disconnect the 
Blumaxx without disconnecting a call. 

At LfSS12y, tile etyBLLf isn’t inexpensive. 

Of course, you're paying for two microphones. Why two? 
According to Etymotic, die combination of an in-ear noise- 
isolating eaq)hone and a boom mic provides better sounti 
quality^ and clearer communication at bodi ends of a 
conversaLkm. That said, the headset is designed lor taking anti 
making phone cidls, not for playing your tunes. 

The etyBLU weighs less than .5 ounces and has a range of 
around 30 feta, ft boasts up lo seven hoims of talk lime and up 
to too hours (if standlry time. It takes 2-3 liours to fully cliarge 
the headset; you can get an 80 percent charge after one hour 

Unlike Apple’s iPhone Bluetooth Headset, which has a 
foam-covered eartiud, the etyBLU uses an in-cunal earpiece. It 
comes with two sets of small and regiilar-si^ied triple flanges, 
and one foam altemativeNote whose ear tip fits snugly in the 
ear. So snugly that scime people find it uncomfortable. But it’s 
great at bkxrking out noise. 

In fact, it’s so good at it tliat you should take tlie etyBLU off 
when you're not using it so you can hear the world around you. 
For that reason, be very careful when ytju're using it while 


driving (and many folks will use it for just that to allow Ixmds- 
free conversation) as you won’t be able to hear through one eiin 
The earpiece in ilie etyBLU headset has a .special filter that 
smoothes tlie frequency response and prevents earwax from 
entering the eaq^hone. The filter is located at the end of the 
eaqphone and is visible when the eanhp is removed. You should 
change tlie filter if loudness decreases or the sound quality 
declines. Filters aren't reusable, but the etyBLU comes with an 
extra earpiece filter and filter replacement 1(K)L 

'Fliere are two volume liuttons located on 
the side of the etyBLU and one port on its 
bottom. Tlie port is w^here you can plug in an 
included USB charging cable or the boom mic. 

Etymotic also tosses in a metal ear-hook, 
which can be used for extra stability, and a 
foam windscreen. 

The elyBLU lias a slim black design with 
a silver multifunction button that calls to mind 
(probably intentionally) the Apple Bluetooth 
Headset. It measures l.R inches long by 0,5 
inches wide by 0.5 inches thick, 'lliere's also 
an LEU mdicator light underneath the button. 

Tlie eiyBUr offers features you'd expect 
in sucli a lieadset: tlie ability to answer, end, 
and reject c'alls, last number redial, voice 
command .support, call waiting support, three- 
way calling support, and tlie ability to transfer 
a call to the handset and vice versa. 

When you're ready to use the etyBLlI 
headset, it’s discoverable ft>r five minutes after 
you power it on. To pair it with a device, such 
as an iFhone, you; 

® I'urn the phone OFF and then back ON. 

° Turn on the mobile plume's Biuetooth function. 

^ Press and hold the MultidTinction Button (MFR) for five 
seconds. The blue LED will flash rapidly when ready tor 
pairing.The etyBLU stays in pairing mode for five 
minutes. 

“ Activate the searcii for Bt* and/or audio devices on the 
phone When the etyBLU is found, the phone will display 
“etyBLU.” Scroll to it and press OK to confirm pairing. 

“ If a passkey/password is requested, enter 0000, 

The etyBlXi is compliant with Blueiooth Core S^mcificaiitm 
2.1, Headset IT and Handsfree 1.5 profilers. It comes witli a rw^o- 
year wananty. , _ , 

iiif 
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THE MACTECH SPOTLIGHT 



Philip Goward 
and Greg Scown 


SmileOnMyMac 

http://www.siTi ileonmymacxom/ 



What do you do? 

Company Co-Founders 

How long have you been doing what you do? 

Greg Stx)wn: IVe been an indie software de\^eloper for 
over seven years, since 2002. My hist job oui of college was 
with Apple. 1 had a few jobs l>etween dien and now, mt>sdy 
oriented toward raising money to take another shot at !>eing an 
indie software developer 

Philip Goward: IVe been witlt SmileOnMyMac for close to 
6 years now. Otherwise IVe been working in software ft>r afK)ut 
20 years, witii a hx-as on t^bjecis, user interface and graphics. 

What was your first computer? 

Greg Scown: TRS-BO Color Computer from Radio Shack, 
My first Mac was a PowcrBcx>k 140* 

Plnlip Goward: Sinclair ZK-81 until 1 saved for an Act)rn 
Atom. 

Are you Mac-only, or a multi-platforai persoa? 

Greg Scown: I'm a Mac person, but not quite a Mac zealot. 
I have some laniiliarity with the forces of the dark side. 

Philip Goward: I've worked on many systems, but the Mai¬ 
ls where my heart is. 

What attracts you to working on the Mac? 

Greg Scown: Community, ihere^s an excellent community 
of users, developers, and fans i>f the Mac. Tiiey're ilemanding, 
and they're great. 

Philip Goward: Quality, Folks developitig for the Mac love 
wlial they do, and it shows. 

What's the coolest thing about the Mad* 

Greg Scow'n: The whole package. I'he ftict that the sum of 
tile hardware and software is greater than either alone. 

idiilip Goward: With the Mac tiie l>eauty is not just skin 
deep. The software on a Mac is as well-designed as mactiines 
themselves. Even my technology-averse Mother can use it. 

What is the advice you'd give to someone trying to get into this 
line of work today? 

Greg Scown: Follow your passion. Engage the Mac 
community Work really hard. 


Philip Goward: Fix'us on what you are learning each step 
along the way. 

What's the coolest tech thing you've done using OS X? 

Greg Scown: I wrote code lo ilow text around a circle live 
wliile typing. This taught me that Mac OS X was tlie real deal, 
and ii was pan of the inspiration for DiscLahel. 

Philip Goward: T'm partly siuinped because I find the cool 
factor to always be in algoiithms that use llie OS routines lo 
their max. Otherwise, the Quartz Composer work in 
BrowseBack that makes the screen slide tiiagonally badewards 
is pretty cool 

Where can we see a sample of your work? 

Everything we do at SmileOnMyMac is colialx>rjt(oii. You 
can look at our work at: http://wwvv. smileonmymac.com/ 

The next way Pm going to impact IT/OS X/the Mac universe Is: 

Greg Scown: Listen to our customers. G>ntinue lo improve 
our software, 

Philip Goward: ...To keep on going. 

Anything else we should know? 

Greg Scfjwn: ! got starred on the Mac liecause 1 helped 
answer a PC quesUon in my college library. I ltapj)ened to do 
so in front of the lab manager, and she offered me a job. We 
liad 70 Macs and 6 PCs. 1 learned an awful lot about Macs in a 
short time at dial job, 

Pliilip Goward: I've never looked Ixick since my SE30. 


Yili 


U you Of someom you know b^eags in the Hhdedt ^t^, kt us 
knowl Settd(kt<^toedHorii^@mattediMm 
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FIND THE PERFECT GIFT. 

DADS &®1M1 

Smalldog.com/fathersday Smalldog.com/graduation 

Small Dog Electronics has over 3,000 potential gifts in stock, so you're 
sure to find that perfect something. Plus, we offer: 

» Free shipping on purchases over $200 
» Mac bundles and tax-free shopping 



FEATURED GIFT IDEAS 


For Dad, recent grad or anyone! 

» Purchase any Mac with AppleCare 
and get a free Canon MP190 all-in-one* 
» Small Dog exclusive rebate; visit 
Smalldog.com/sderebate for details 

•After maii-in rebate 

Everybody loves iPods 

» 16GB iPod touch for the 8GB price - 

$229.99 

» iPod specials from $159.99 


Perfect for the college dorm 

» Buy the iPod Essentials 4-Pack 
(Chill Pill + Adapters -i- RapCap mic) 

for just $79.99 (save $40) 



Small Dog 

Electronics 

^our €lde> 



• over 15 years in the Hac communlly 

* 3,000+ products tor Macs + PCs 

• 5-star online merchant rating 

* tax-tree shopping outside ol VT 


WWW.SmalldOiCOm 800-511-NACS m Apple Specialist 










Call MacMall for our latest 
specials with your NEW Mac! 


6 Months 
Same as Cash! 

V dif/AjrpufdiassovEf ^ {]sf ^ 

Up to 

^250 Cash Back!* 

Qn Miecr frtun twr or 

kww.mtJiL'nd^.ciwn. AfermsiNrt rebare. 

FREE Parallels 
Desktop!’ 

^ JliMJre A'':.'? pwdwse 


NEW 15" Aluminum MacBook Pro 

2.4GHz with 2GB SDRAM and 25QGB Hard Drive 

FREE Parallels Desktop!' >..c:jae5N€-,’iUfe 0^' 


n994~^150mdNn 


it76&402Q 


SAVE 5150! 

17" MacBook" Pro 
2.66GHz with 4G8 SDRAM, 
320GB HD and SuperDrive 
Parallels Desktop!' 


NEW20"iMac 
2.66GHzwith 2GB SDRAM, 
320GB HD and SuperDrive 
rREE Parallels Desktop!' 

§77SB229 *Mtsrmdl4nrebom. 


Apple^ iWork'“ '09 
Word prtxesiihg, sprsodstets 
G(\d pfesenfcjfibfis dm put the 
fun bock /nfoyoi/r wade' 


LaCie 1TB d2 Quadra 
External HD 

eSATA JGb4 Fkemf^m, 
FiT^WmmondiUSE2.a 


13" MacBook' 
2GHz with 2GB SDRAM, 
160GB HD and SuperDrive 
Parallels Desktop!' 


^2794-^50^ 

#7732924 *After moiFin rebate- 


^U94-^65^ 

#75040/5 ^Aftsermaii-in rebate. 


7/iS 

•^r #?7229JQ 


#770256/ 


ll Authorized Reseller 


Source code: MACTECH 


Vbuf #7 Apple Supersto^! 

Cali 1-877-233-2838 or visit ma^ mai 

'CASH BACK-Purchase select computer models from MacMall and receive up to S250 cash back via MacMall maiMn rebate. Ends S/17709. • FREE PARAgiLS DESK! 

roail-lri rebates with purchase of any new Apple computer. Prke before rebates is $00. Encls 5/17/09. * ALL OFfEHS VAUD WHILE SUPPLIES LAST, Dd^nload reh 
pletse visit our Web $Jie and enter the appi Icabie part rrumber. Although we do our be^ to achieve 10D% accuracy, occasionally errors and Inaccurades diiroccL.jr Sht 










